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B1800/81700 Systean Software Release Mark VII.0 
1. General Information 


lel. Introduction. 


The Mark VIIT.0 software release includes a number of major 
enhancements» described in detail in the fotlowing sections of 
this release document. Among the new enhancements and features 
are the’ following (the numbers in parentheses refer to the 
paragraphs in this document that describe the features in 
detail): | | : 


1. New memory management algorithms have been implemented in 
the MCP». using three optional levels of sophistication and 
complexity (2.2.2). 


2- Capabilities for dynamically monitoring and displaying 
system performance have been epregented in the MCP and 
GISMO/DEBUG (262-3). 


3e Wi venuabens have been replaced by job-numberss allowing use 
of a singles consistent nuaber for all job identification 


4. The XM function has been implemented in the MCP and System 
Initializer CSYSTEM/INIT)»  atlowing specified areas of 
memory to be removed from use during the CLEAR/ START 
operation (2.2.10). a4 


5. The meaning of the STATE Light has been changed to attow 


providing amore accurate and meaningful indication of how 
*"busy*™ the processor is (222.13). . 


6. The B 1800/8 1700 Time Analysis and Billing System CTABS) 
has been iaplemented»s including new event-oriented records 
placed in the SYSTEM/LOG by the MCP (2.2.39 and 20-1). 


re The capabitity to create Installation. Allocated Disk tiles 
has been imptemented in the MCP and anew utility program, 
DISK/ALLOCATOR (2.2.40 and 18.2.5). 


8. The AUTOLOAD facility has been implemented in the MCP and 
DISKETTE/COPYs attlowing pseudo-reader files on diskatte to 
be copied to system disk without operator action (242.44 
and 18.2.6). 


9. The two methods for 1/0 SEQUENTIAL disk file access» 
originally taplemented in patch #40 to Mark VI.1» have been 
included in the Mark VII-0 MCP and MICRO-MCP (2.2.64). 
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39.6 


The Supervisory Message Control System (SMCS) program 
products |. designed to be the “supervisor” for a 
highlycinteractive data communications system» Js now 
available (13.1). . 


The HOST RJE system now includes a CALLBACK facility> 
allowing a remote terminal user to log off and then be 
automatically called back when his jobs have been conpteted 
C15.2e1). . . . 


The RJE3780 program product» which allows the 8 1800/B 1700 
to perform as an RJE station to a host system using the 
IBM 3780 discipline» is now available (16.1). 


"Hot Readers» ‘as well as new local commands» have been 
implemented in HASP (1742.23 and 17.244). 


DMP ALL is now able to process ISAM input files 
sequentially» using the associated TAG file as the source 
of the relative record numbers (16.2.8). 


A disk reconfiguration option has been implemented in 
PACK/INIT and SYSTEM/DISK-INIT» allowing the pack type to 
be changed without teinitialization (18. Ze 12). 


The capability for declaration of Sac lane COLLATE. Papen 
has been iaplemented in SORT (18.2.14). 


SORT now has the abitity to produce COBOL-. and 
RPG-compatible TAG files as output €18.2.14). : 


SORT now provides. a capability for maintaining the original 
order from the input file of all records that have equal 
key fields (€18.2.14). 


As new freestanding. system utility programs 
STANDALONE /DISK.OUMP » is now available» which allows 
copying of files between two disks in a file~by~file sode 
rather than sector ~by-sector mode (18.2. 15). 


SYSTEM/COMPARE>» a generalized system ceiies program for 
comparing files» is now available €18.2.17). 


SYSTEM/ELOGOUT has been redesigned» providing more readable 


and useful reports C€18.2.18).. | 


SYSTEM/ICMD.INET> a normalestate program used for 
initializing the diskette» is now available (18.22.19). 


SYSTEM/MARK.SEGS> a new system utility program used for 
marking “important” code segments (for use with Priority 
Memory Management and Extended Segment Decay)» is now 
available (€18.2.21). 


40. The 8500 Magnetic Tape Memory Write (MWR) instruction is 
now supported in the 8500 Interpreter (19.2.1). 


41. The 8500 Interpreter now supports the B500 "“double"density” 
disk €19.2.2).4 


42-e The ability to separate object progran files and data files 
has been provided in the 1400 Interpreter (19.5.1). 


Specific details on these and other enhancements is contained in 
the varfous sections of this document that follow. where 
aoplicable> temporary documentation on syntax and use of new 
functions is also provided. 


de2s Software Included with the Mark VII.0 Release. 
The following List details the software that is available as part 


of this release. Programs preceded by an asterisk are being 
released for the first time on Mark VIT-0. 


Program Identification Version Compile Date Remarks 


MCPIT — a VII 2001 7/11/78 
MCPII/MICRO.MCP VII.0 5/25/78 
MICRO.MCP/DEBUG VII .0 5/25/78 
GISMO , VII.001 7/1/78 
-GISMO/DEBUG VII.0.1  7/.1/78 
BASIC. : VIel — B/22/77 
BASIC INTRINSICS Viel 5/9/77 
BASIC/INTERP3S_ | VII-0 ~ 4/18/78 Note 1 
‘BASIC/INTERP3M = . ~— VITO 4/18/78 Note 2 
COBOL | < VII.0 6/4 8/78 : 
COBOL/XREF VETO 7/11/78 
COBOL/INTERPLS WVIIT-0 6/20/77 Note 1 
COBOL/INTERP 1M VII .0 6/20/77 Note 2 
DASDL | VII.0 6/10/78 
RECOVER/DATA.BASE VIT.O «64 1/78 
OMS/REORG.READ VIT-0 4/ 4/78 
OMS/REORG.WRIT | VII.0 5/ 3/78 
RPG VII.0 3/14/78 
RPG/BTF VII.0 8/ 7/TT 
RPG/REORD | VII.0 8/ 7/77 
RPG/REORG VIT.0 8/ T/T7 
RPG/ XREF VI.0 8/29/75 | 
RPG/INTERP1S : VII-0 (1/26/78 Note 1 
RPG/INTERP 1M VIT .0 1/26/78 Note 2 
FORTRAN VIT.O | 6/15/78 | 
FORTRAN INTRINSICS VII .0 6/15/78 
FORTRAN/INTMAKER vel 1/12/76 | 
FORTRAN/INTERP 1S VITO 6/ 5/78 Note 1 
— FORTRAN/INTERPIM | VII.0 64 5/78 Note 2 
UPL 7 |  “VET.O 2/20/78 
SDL/ERRORS . VII.0 10/19/77 
SOL/XMAP . VII .0 3/23/77 
SDL/XREF VIT.0 10/27/77 
SDL INTRINSICS VII.0 8/19/77 
SOL/INTERP1S VIT-O © 10/10/77 Note 1 
SDL/INTERPIM VIT.0 10/10/77 Note 2 
NDL VII-O 4/27/78 | 
NOL/MACRO ._ 2 VITO 6/12/78 
NDL/ ADDRESS VIT.0 6/12/78 
NOL/LEBRARY VIT.0 6/26/78 
NOL/OUHP VII.0 4/28/78 
—DC/AUDIT | VII.0 1/17/78 
SOURCE/MCSI | Vel 124-175 


SOURCE /MCSIT VI-l 1/24/77 


Program Identification Version Compile Date Remarks 


* SMCS a VIIT.0 4/28/78 
CANDE VII.0: 5/19/78 
CANDE/ANALYZER | VIT.O. 1/24/78 
CANDE/TEACH.FILE VII.0 11/9/77 

EDITOR V1II.0 6/30/78 

: VII.0 L/17/78 
RJE7DCH VI1.0 1/17/78 
RJE/NCS | VII.0 1/17/78 
RJE/ AUTOBACKUP VII.0 10/10/77 
RJESCONTROLLER VII.0 1/30/78 
RJE/MESSAGES VII.0 1/18/78 

*RJE3780 | VIT.0  6/ 6/78 
HASP i VI1I~0 4/14/78 
HASP/SPOOL VII.0 5/24/78 
HASP/MODIFTER VII.0 2/ 6/78 
B500/LEP VII.0 9/30/77 
BSOO/INTERP2U VII .0 7/12/78 
1400/1EP | VII-9 © 12/ 1/77 
1600/INTERP2U VII.0 | 4/26/78 
1L400/CREATE1311. VI.0 9/ 6/76 
SORT VII .0 3/22/78 
SORT/COLLATE | Viel. 8/19/77 
SORT/HERGE | VIT.O 9/ 9/77 
SORT/QSORT ae. , VII.0 4/ 77/78 
SORT/TAPESORT VIT.0 11/7/77 
SORT/VSORT VIL.0 3/23/78 
MCPII/ANALYZER | VII.0 6/30/78 
DUMP/ ANALYZER — VEL.O 6/22/78 
CODE/ANALYZER VII.0 12/ 7/77 
DISK/COPY VII .0 3/29/78 
DISKETTE/COPY | VII.0 4/26/78 

# SYSTEM/ICMD INIT VII .0 12/21/77 
SY STEM/BACKUP VII.0 6/12/78 

# SYSTEM/COMPARE VII .0 6/28/78 
SY STEM/LOGOUT VIT.0 1/24/78 
SYSTEM/ELOGOUT VII .0 6/ 3/78 
SYSTEM/SPOLOGOUT VI.1 — B/22077 
SYSTEM/LDCONTRE VII .0 11/ 3/77 
SY STEM/LOAD.CAS VII-0 = 9730/77 
SYSTEM/LOAD.DUMP VII .0 5/23/78 
SYSTEM/DISKsINIT VII-0 6/ 5/78 
SYSTEM/DISK.DUMP VII.0 7/28/77 
SYSTEM/BUILDTRAIN VI-1 8/19/77 
SYSTEM/TRAINTABLE VII.0 — -10/21777 
INPUT/PC5.« TABLES VII-0 | 10/21/77 


SYSTEM/MAKEUSER | VIT.0 1/27/78 


As3. 8 1800/8 1700 Reference Manuals. 


The following manuals have been released: 


#1057155 B 1700 Systems feference Manual (4772) 

#1057155~001 PCN #1 (9-°8-72) 

#1057155-002 __ PCN #2 €9°28°73) 

#1057189 B 1700 RPG Reference Manual (8-77) | 

#1057197 B 1800/8 1700 COBOL Reference Manual (9°77) 

#1067170 B 1700 UPL Reference Manual (12773) 

#1067535 B 1700 BASIC Reference Manual (6-73) 

#1068731 8 1800/78 1700 System Software Operational Guide (8°78) 
#1072568  B 1700 MIL Reference Manual (5-77) 

#1073715 -B8 1700 NDL Reference Manual (6°77) 

(#1081346 B 1700 SOL Reference Manual (12°74) 

#1081882 8 1800/B 1700 FORTRAN Reference Manual (4776) 
#1088010 .8B 1700 MCP Reference Manual (8- 75) 

#1089794 8 1700 DMSII Reference Manual (1776) 

#1089992 B 1700 Data Communications Information Manual (12°75) 
#1090578 B 1700 HASP Reference Manual (8-76) 

#1090586 B 1700 CANDE User*s Manual (8-76) 

#1090602 B 1600/B 1700 RJE Reference Manual (7°78) 

#1090610 B 


~1800/B 1700 TEXT/EDITOR Reference Manual (7778) 


The revised edition of the B 1800/81700 £System Software 
Operational Guide (dated 8-78) is now available for distribution. 
This revision of the manual contains detailed descriptions of att 
new features and utility programs available with the Mark VII.0 
releases and should be reviewed thoroughly prior to attempting 
installation of this software Level. 


Reference witl be «ade throughout this release document to new 
features and programs» where specific documentation is contained 


in the revised B 1800/8 1700 System Software Operational Guide. 
Detailed information on such features and programs is not 


included in this release document. 


ds42 8 1800/8 1700 Software Flashes. 


The following 


Elash 


i753 
176 
177— 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
(190. 
191 
192 
193 
194 
195 
196 
197. 
198 
199 
200 
201 
202 
203 


list — reflects 


Release Eixeg 


VI.1 
VI.i 
VI.l 
Vial 
VI.1 
VI.1 
VI.1 
VITI.0 
VIL.0 
VII .0 
VI1.0 
VII .0 
VIT.0 
VIT.0. 
VIT.0 
VI1I.0 
VII .0 
ViI.0 
VIT.O0 
VI«1l 
VII .0 
VII.0 
VII.0 
VII.0 
VIT.0 
NWIT.O 
VII.0 


the current. status of alt 
B 1600/8 1700 Software Flashes issued since January ls» 1977: 


Remarks 


Information only 


-Atso. 


RPG VI-eL-1°V1I.~1.5 


Information only 


Also 
Also 
Also 
Also 


Also 


Also 


Also 


SYSTEM/LOAD.CAS VI-1.1 


FORsINTRIN Viele! 


COBOL VI.1.4 


RPG V1I.1.8 


DASDL VI.1.4 


MCPIIT VI.1.69 
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25 MCPEI (SMCP) 


Z2le Introduction. 


In addition to the implementation of new MCP Memory Management 
algorithms» a number of enhancements have been included in the 
Mark VII.Q MCP. Among these are the replacement of program mix 
nuabers by job numbers» the ability to explicitly remove portions 
of memory from use (XM)» and the ability to explicitly altocate 
disk files CInstaltation Attocated Disk). 


Each of these changes /enhancenents is documented either in the 
paragraphs that follow or in the revised 8 1800/B 1700 Systee 
Software Operational Guide. 


2222 Enhancements. 


Sehels , 

The following probleas reported in the Mark VI.1 retease tetter 
have been. fixed (the numbers in parentheses refer to the 
paragraphs in the Mark VI-1 release Letter which originally 
described the problem): : . 


a» Information beyond column 72 is now ignored in allt control 
cards (2.3. 7). . 


be SYSTEN/LOAD DUMP will. no longer start executing due to a 
feed checks read check» or empty hopper while reading input 
cards for an ADD» DUMP» LOAD» or UNLOAD operation. An 
ending semicolon is required before SYSTEM/LOAD.DUMP will 
begin (2.3.8). 


Ce Programs waiting on a COMPLEX.WAIT can now be marked as 
candidates for rollout (2.3.10). Untess “frozen"» any 
program waiting on a COMPLEX.WAIT will be rotted out if 
none of the events upon which it ts waiting has occurred 
after two (2) MCP N.SECOND intervals. 


d. Entries in the ELOG for disk errors on euleiple system 
drives now contain the correct unit-mnemonic (2.3.11). 


es. USER.BACKUP.NAME files on the PBO-DESIGNATION disk can now 
be printed/punched without the necessity of including the 
packcid in the PB message (2.3.12). 


f. Closing an output printer or punch file with PURGE no 
longer fails to enter the file in the directory if it is 
directed to backup disk (2.3.13). 


Ce 
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If a program which has. a charge number catls a SORT 
intrinsics the charge number is now passed along to the 
intrinsic regardless of the setting of the CHRG option 
C2.3.17). 


It ts now posstble to print/punch more than one secured 


backup file with a single PB command by the use of the 
fotlowing message format: 


USER=<usercode>/<password> PB <specifier> 


where <specifier> can be =/=s PRT/=.5 $PRN/=s5 or PCH/= 
(2.3.18). yee 


Printer/punch files are no Longer automatically directed to 
backup if the REPETITIONS value is equal to one (2.3.19). 


The <integer> used with the AB input message cannot be 
greater than four (2.3.20). . 


System failures no longer occur when a tape file is closed 
CNO-REWIND) when not at EOF and an attempt is made to 
reopen the file (NO.REWIND) €2.3.21). 


A CL message referencing a MICR Reader~Sorter no tonger 
hangs the MCP (2.3.23). 


A PG or RP input message that references a tape drive with 
no tape mounted on it no tonger results in a spurious 
NO. WRITE RING message (2.3425). 


If a tape with a single-track error is mounted» the MCP no 
longer toops indefinitely trying to ready the unit 
(2.3426). 7 


If AUTOPRINT is actives any printer backup disk file that 
is closed will now be entered in the AUTOPRINT QUEUE> 


regard@less of whether or not the backup file is directed to 


the PBD.~DESIGNATION disk or has a family-name of BACKUP.PRT 
(2.3.27). A new attribute of the FILE statement» 
AUTOPRINT» may be used to prevent the file from being 
entered in the AUTOPRINT QUEUE Crefer to paragraph 2.2.9 of 
this document and to the revised Software Operational Guide 
for details). 


If SYSTEM/BACKUP is executed by AUTOPRINT and na printer 
has been reserved with the AB input messager the message 
requesting a printer now.indicates that an AB message is 
required (2.3.30). 


MICR Reader-Sorter programs can. now be DS~ed without 
causing MCP problems (2.3.31). 
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222222 7 = 
New MCP Memory Management algorithms have been implemented» on 
three Coptionat) levels of sophistication and complexity: 


ae First-iIn» First-Out 
b. FirstrIne First-Out with Thrashing Detection 
' Ce Memory Priority with Thrashing Detection 


Complete documentation on the implementation, operational 
details» advantages» and disadvantages of each of these levels is 
contained in appendix A of the revised Software Operational 
Guides .§ A thorough review of this documentation is recommended» 
because a number of new operational features are connected with 
the new Memory Management algorithms» including the concept of 
separate Memory and Processor Priorities» Extended Segment Decay» 
and specification of thrashing detection parameters. 


Lahade | 2% 8 | 

Capabilities have been implemented in the MCP Cin conjunction 
with GISMO/DEBUG) for dynamicalty monitoring and displaying 
system performance on the system console. Complete documentation 
on these powerful per formance-monitoring features is included in 
appendix 8B of the revised Software Operational Guide. — | 


£2242 | j 
-Any program that is executed is now identified by a single 
nugbers the job-number» from the time that the program is 
scheduled until it reaches end-of-job. Mix-numbers» as such» no 
longer exist. Job-numbers are incremented from 1 through 9999» 
at which time they are reset to 1 by the MCP. 


Alt references to a program (whether in the mix or in the 
schedule) are now made using the job-number. Prior to Mark 
VII~QO» some messages used the mixenuaber as a parameter and 
others used the jobenumber. - 


A second nuabers the Job Accounting Numbers is maintained as a 

completely unique job identifier for the purposes of the system 
loge This number is not reset at 9999 (the maximum value is 
16777215)» and is onty accessible to programs which process the 
og file. | 


£22232 a | : | 

Because each prograa@ now has a unique jobenumbers» programs such 
as SORT intrinstcs (for example» SORT/VSORT) are no tonger 
"hidden*®. That is» such jobs (referred to as “"task$s") paw 
display their beginning and ending messages on the SPO. These 
messages identify the “beginningcof-task" (80T) and “end-of-task" 
CEQT)» and specify the program which “called” the task Cas the 
job-nuaber contained in parentheses). 
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 Lelebe ee . | 

For compatibility with 8 7000/8 6000 series systems» the 
PROTECTION and PROTECTION.IO attributes have been changed to 
SECURITYTYPE. and SECURITYUSE» respectively» for use with the FILE 


statement and the MH input message. The abbreviations are as 
follows: a 

SECURITYTYPE . SEC 

SECURE TYUSE SUS 


The PROTECTION and PROTECTION.10. keywords (Cas well as their 
abbreviations) are stilt allowed for Mark VII.03 howevers they 
will be deleted in a future release. 


2e2als | 
Session numbers (specified in Job Spawning Controt Instructions 


with the SZ controt attribute) have been divided into three 
distinct ranges» each with different characteristics and 


restrictions. Complete documentation on session numbers is 
contained in the revised Software Operational Guide. 
£26280 


The maximua. CHARGE number that can be specified has been 
increased to seven digits (9999999). 


a2h29e | . | 

The AUTOPRINT attribute CFILE statement) has been implemented. 
This attributes» which is SET by default» specifies that a printer 
backup file is to be entered into the AUTOPRINT QUEUE when the 
file is closed. Specifying “NO AUTOPRINT™ prevents aie oprinter 
backup fite from. being printed by the MCP AUTOPRINT mechanism. 
The AUTOPRINT attribute may be abbreviated as ATP. . 


In Mark VI.1>» any printer backup file having the default 
familytname  C"™BACKUP.PRT"™) and which resided on the 
PBD.DESIGNATION disk was entered into the AUTOPRINT QUEUE when it 
was reteased. In Mark VII-O» all backup files are entered into 
the AUTOPRINT QUEUE when they are released» unless "NO AUTOPRINT™ 
is specified. _ Backup files already existing on disk when 
AUTOPRINT is invoked (for example» when the AB message is 
entered)» are onty placed in the AUTOPRINT QUEUE if they have the 
default family-name and reside on the P8D.DESIGNATION disk Cfitles 
with "NO AUTOPRINT" specified are still ignored by SYSTEM/BACKUP> 
even if they are found in the AUTOPRINT QUEUE). 


L2eh2h0e2 

The XM input message has been implemented» allowing expticit 
removal of specified areas of memory from use by the system. The 
specifications made in the XM message are entered by the MCP in a 
table (the XM TABLE) maintained on disks actual deletion of the 
designated areas is performed by the System Initializer during 
the next CLEAR/START operation. Complete documentation on the 
syntax and usage of the XM input message is contained in the 
revised Software Operational Guide. 
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2e2alle 7 | 
The PROTOCOL attribute CFILE statement) has been implemented» 
allowing a value to be passed from a program to an MCS in the 
remote file OPEN and OPEN“REPLY messages. Refer to paragraph 
10.4211 of this document and to the revised Software Operational 
Guide for additional information. 


£2222 

The "“file-identifier RELEASED" message is now only displayed when 
a backup file is closed if the BREL (Backup File Released) option 
is set (refer to the revised Software Operational Guide for 
details). . 


222213. | | 

The information provided by the STATE Lights» when running without 
the performancecnmonitoring features has been changed in order to 
provide a better indication of how “busy” the processor is- 


The implementation prior to Mark VII.0 attempted to distinguish 
between “normal state” and “control state". The STATE light was: 


ON When either the SMCP or the MICRO.SCHEDULER is running. 
OFF When the MMCP or any user program is running. 


The problem with that implementation was that it provided tittle 
information about how busy the system reatty. is» since both 
meanings of the STATE Light still indicate that the processor is 
being used. In addition» the light could be somewhat misleading 
in some cases. Logical 1/0 operations performed by the MMCP were 
considered as part of “normal state” (user program) time; 
however » there are some exceptional cases of logical I/0 that 
must be handled by the SMCP. These were inconsistently displayed 
as part of the “control state” time. | 


In order to provide a more useful indication of processor uses 
the Mark VII.0 retease uses the STATE Light to distinguish 
between system idle time and nonvidte time. The STATE evaDe is: 


ON When every process in the system is wartine Cigted. 
OFF When the processor is executing some process. 
The advantages of this taplementation are as follows: 


ae The MICRO.SCHEDULER can easily and unambiguously provide an 
indication of how busy the systea is. 


b. With control of the STATE tight timited to the 
MICRO.SCHEDULER Cuntike previous releases» where each 
interpreter set or reset the Light as it gained or gave up 
controt)>» other performance-monitoring functions can be 
provided through the STATE Light. 
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~The main disadvantage is that it is different. To someone who is 
used to previous releases» the user job appears to be very busy 
Cunless the system is idle)» or it may even appear to be hung in 
a loop. 


Le2eibe . 

The MCP no longer Locks an input multi-file tape when end-of-reel 
is encountered during a multi-file search. Note: this change 
results in the same tape being searched again if another tape 
with the same family-name is not mounted and ready prior to the 
first tape rewinding to beginning~of-tape. | 


Lalelds , 
The following changes to the MCP printer/punch ‘backup mechanise 
have been made in this release: 


ae It is now possible to print/punch alt. backup files on disk 
having a specified family-namer using a “PB <family>/s=" 
input message. No options other than SAVE» LABEL» or 
LABELS may be specified when using this form of the PB 
message- For examplere | | 


PB THO.PLY/= 
PB DPC BILLS/= LABELS 


be Printer/punch backup ~~ files created with the 
USER .BACKUP.NAME attribute specified are not removed fros 
disk by SYSTEM/BACKUP after they have been printed/puncheds 
unless switch 2 in SYSTEM/BACKUP is set to a non-zero 
value. This feature does not apply to any backup file 
whose name 5 siaply changed toa a non-de fault 
backup-file-identi fiers USER -BACKUP.NAME must have been 
specified when the backup file was created. 


ce Alt output printer/punch backup files are now directed to 
the P@D-DESIGNATION disk Ceven if a specific pack-id has 
been designated for the fite)» unless the USER-BACKUP-.NAME 
attribute is set. This does not apply» however» to secured 
backup files» which are directed to the default pack 
specified in the (CSYSTEM)/USERCODE file. If no default 
pack is assigned» secured backup files are directed to the 
PBD-DESIGNATION disk. 


Additional documentation on all features of SYSTEM/BACKUP and the 
PB input message is included in the revised Software Operational 
Guide. 


SalealOs | | 

The Network Controller identified in the NAME TABLE witt no 
longer be executed more than once when multiple Data Comm jobs 
are executed at the same time. 
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SeZehTs | e 

The MCP now prevents a “DYNAMIC «wee FILE eo-" control instruction 
from referencing any fite that is not completely closed. A file 
is not closed if a Fite Information Block (CFIB) is still 
assigned, the FIB is only returned when the file is closed with 
RELEASE» LOCK» PURGE» or REMOVE (the MCP doese however» atltow a 
"DYNAMIC" controt instruction to reference a tape file that has 
been closed with NO.REWIND). A "OYNAMIC™ control instruction. 
referencing any of the following attributes is allowed by the 

MCP» however» whether or not the file is completely closed: 


EOP 

AUTOPRINT 

INVALID .CHARACTERS 
LOCK 


ao a similar manner» the MCP prevents a WRITE-FPB communicate by 
program from referencing a file that is not completely closed. 
Por Mark VII.0» a warning message is displayed and the WRITE.FPB 
is allowed to proceeds in Mark VIII.0» the program will be DS~ed 
tiamediately. For COBOL programs which use the "VALUE OF ID IS 
datacname"™ constructs WRITE.FP8 communicates are generated by the 
compiler (transparent to the programmer). Since it is impossible 
to have control in the source program over when these 
communicates are issued» WRITE-FPB communicates by a COBOL 
prograa which reference a file that is not completely closed are 
siaply ngnored by the MCP (no warning message is disptayed). 


£22218. 

If the defautt pack specified for a usercode is not present when 
an output disk file is opened by a program running under that 
usercode, the MCP sets the *"override®* bit in. the 
CSYSTEM)/SUSERCODE file» directs the file to the system disk» and 
displays a warning message on the SPO. Once the override bit is 
set» alt output files created by any program running under that 
usercode are directed to system disk (without any warning 
messages)» regardless of whether or not the required pack ts on 
line. The override bit can be explicitly. reset using the RV 


input message. Refer to paragraph 2.2.52 of this document and 
also to the revised Software Operational Guide for details. 
£22242- 


The RM response to a  ODUPLICATE FILE situation with 
SYSTEM/LOAD.«DUMP no tonger causes the output file to have 
incorrect attributes (Flash #190). | 


22222902 | 

A disk SQUASH operation referencing Electronics Unit 1 of a 
head-per-track. system disk no tonger halts the system with an 
irrecoverable “NOT READY" disk exception condition (Flash #199). 
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2e2e2ls | 

The MCP now generates the correct 1/0 opcode for Extended Result 
Descriptor (ERD) reads on 8 9484 Disk Packs ‘connected to Disk 
Pack Controte+1 (Flash #203). 


222222 


The MCP will no Longer reinstate a program Sear displaying the 
following terminal error message: 


TAPE NOT POSITIONED AT EOF1 CABEL 
2a20230 


It is no tonger possible for a program running under a 
non-privileged usercode/password Cor a program not. running under 
File Security) to open a secured output disk file having two 
names where the familyconame is not the same as the usercode. In 
addition» a program which is not running under a privileged 
usercode cannot CLOSE an existing secured disk file with PURGE if 
the family-name is not the same as the usercode. 


One of the areas most often affected by this security improvement 
is where it is desired to PB a secured» public backup filer using 
the following input message: 


PB (<usercode>)/#<int eger> 


Since SYSTEM/BACKUP is executed without a usercode in this caser 
the backup file cannot be closed with PURGE» and remains on disk 
after printing. The proper way to do this would be either to 
prefix the PB message above with a privileged usercode/password» 
or to enter the message as follows: 


USER=<usercode>/<passwor d> PB <integer> 


kohelhs 
A NOT READY encountered on a tape unit ‘auctngs a tape file OPEN no 
longer hangs the MCP. 


2e2e220 


The MCP now handles blanks within file-identifiers on tape labels 
as follows: . 


ae Leading blanks are disallowed» 
be Traiting blanks are truncated» and 
ce Embedded blanks are allowed. 


B22226e aoe ; | ; 

The MCP will now initiate a physicat WRITE of the last partial 
block on a tape output file following a CLOSE request if the 
preceding 1/0 encountered end-ofereels» preventing a program hang. 
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B22e2Te | 
The MCP wittl no longer halt when attempting to sort a 
variable-length record disk file having an EOF .POINTER of zero. 


2222282 | ; 
The MCP will no longer halt with an INVALID CASE when processing 
a WY input message referencing the NOL Network Controller. . 


222229 | 

The MCP will no tonger halt if an attempt is made to assign an 
input card fite which has stacker-select specified to an 
8O0-column reader. — ; 


risers a Ho | 

CL message referencing the MICR Reader-Sorter or a DS of the 
ounae is now allowed after receiving the fotlowing error 
message: oS 


POCKET LIGHT COMMUNICATE REQUESTED WHILE SORTER FLOWING 


Leolasdle . 

A TERMINATE card no tonger halts the MCP if the filetidentifier 
is omitted. The TERMINATE card is now ignored by the MCP if the 
filewidentifier is missing or does not match the pete wean ethene 
on the corresponding STREAM card. 


2e2a320 e 

The MCP now atlows an SD to be requested on a disk initialized as 
SYSTEM (C€S)»s without having to first reinitialize the disk as 
UNRESTRICTED CU). ; 


2222330 | oo | : 

A MX» WYs or WS= message entered on the host SPO now displays all. 
jobs running or in the schedules without the necessity of first 
setting the RMSG option. 


222234 e . 
ALL known problems causing MCP NAME/VALUE STACK OVERFLOW halts 
have been fixed. 


An ST message now forces the NeSECOND routine to be catted 
immediately» causing immediate rollout of the stopped job. In 
additions a new option of the ST message allows a program to be 
stoppeds then automaticatty restarted when another program in the 
mix terminates. Refer to the revised Software Cperationat Guide 
for details. 


2222362 | 
The St tnput message no tonger altows non-numeric parameters to 
be specified. 
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(2222302 | , es os | 
A space is now required to delimit bit-type operands (those 
enclosed by “at™ signs) in the CP input message. 


2222382 | | __. 2 

The NC option of the PM input message is no tonger atltowed. 
DUMP/ANALYZER automatically zip-executes NOL/DUMP after printing 
the analysis of an NOL Network Controller dump. 


2222392 | | 

The TABS option has been implemented. When this option is set» 
the MCP includes certain additionat records in the LOG for use by 
TABS CTime Analysis and Billing System). Refer to the TABS 
document and to the revised Software Operational Guide for 
further information. . fr _ 


£22040 2 | . | . 
The MCP now provides for creation of disk files with 
user-specified § attributes and absolute — disk addresses 
(Installation Attocated Disk). Refer to the. DISK/ALLOCATOR 


section in the revised Software Operational Guide for detaits on 
Instaltation Allocated Disk. 


2a2241e 3 | se 48 
The IC CInterpreter Count) ‘input message has been implemented» 
allowing specification of the maximum number of interpreters that 


can be run concurrently. $Refer to the revised Software 
Operational Guide for further information. 
LZale4tis 


The MCP now attempts to do a “deep read* (for error correction) 
on cassette tape. This capabitity requires installation of a 
hardware change to the cassette control (LIN #1L6958-002 for 
hybrid controts and LIN #l6958-°003 for wirewrapped controts). 
Attempting to use cassette tape on Mark VII.0 without the proper 
hardware change installed will hang the MCP. #£This is applicable 
onty to those 8 1800/8 1700 systems that have magnetic tape 
cassette peripheral units (which provide the ability to write 
cassette fites)>, not to systems which only have the console 
cassette drive. ae 


2222432 | 
The REWIND CASSETTE. message displayed ay the System Initiatlizer 
during a CLEAR/START operation has been deleted. A SYSTEM MEMORY 
DUMP COMPLETE message is displayed by the MCP» #£however>» if a 
memory duap was requested during the CLEAR/START. 


£242 4h2 3 

- Automatic loading of pseudo decks from diskette has been 
jupleaented in the MCP. A pseudo deck on diskette is identified 
by the presence of “"“PSR*® in the first three bytes of a header 
label. Refer to the DISKETTE/COPY section in the revised 
Software Gperational Guide for further details. 
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Sake2452 . | 
Commas are again required to separate filenames in the List of 
files specified in a REMOVE control instruction. © This 


requirement (primarily a safeguard) was inadvertently deleted in 
Mark VI.1l. . 


Saha 4SGa : - 
A tape labeled "SCRATCH™ is now handted property as an input file 


2e224Ts 
The MIX LIMIT CML input message) now applies onty to jobs having 
a PROCESSGRePRIORITY less than De Programs with a 


PROCESSOR.PRIORITY of 9 or greater can enter the mix (given 
sufficient system resources) regardless of the setting of the MIX 
LIMIT. In addition» any job that is executed with a 
PROCESSOR -PRIGRITY of 9 or greater is automatically given a 
SCHEDULE.PRIORITY the same as the PROCESSOR.PRIORITY Cup to a 
maximum of 14)+* unless an explicit SCHEDULE-PRIORITY attribute is 
also specified. Note that the PRIORITY assumes the functions of 
PROCESSOR-PRIORITY if the Priority Memory Management algorithm is 


not being used by the MCP. Refer to the revised Software 
Operational Guide for complete information. 
— £022 4Be 


The Julian date has been added to alt output messages which 
display the current date. cs 


£22490 ar 

The RX input message now requires the serial number of the disk 
as a verification Crefer to the revised Software Operational 
Guide for complete syntax). 


(2222302 
The response to the OL tnput message on a user pack/cartridge now 
includes the number of users currently using the disk. 


rage 
new runtime attribute»  NODIF> has been implemented. 
sdacetie tise of this attribute with a COMPILE» EXECUTE» or 
DYNAMIC control instruction (not allowed with MODIFY) prevents 
the premature terrmination of spawned jobs due to “DEATH IN 
FAMILY*. Refer to the revised Software Operational Guide for 
details. : 


£ehedZe | 

The RV input message has been implemented to allow the "override". 
bit in the CSYSTEM)/USERCODE file to be reset for a particular 
usercode. Refer to the revised Software Operational Guide for 
further information. | 
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2222530 ; = 
The equat sign (=) is now allowed between USER (Cor US) and the 
<usercode>/<password>. a 


S222940 | | | 

The MCP no tonger halts when an ST message followed by a GO 
message is entered for @ program awaiting a Data Comm Open 
Permit. 


2a2255 2 ve 

The MCP no tonger halts when an attempt is made to remove a 
backup file directed to a specific user pack which exceeded its 
maximum allowable size. 


£22236 
The "CORE. copys. of an in-use disk file header is now onty printed 
by the KA routine if the DBUG option is set. 


S2225Te . 
The MCP no longer hatte on an irrecoverable disk I/O error or an 
invalid key when attempting to enter a message in a queue. 


£22228 7 
The MCP no longer halts with a READ OQUT-OF-BOUNDS while 
processing a QC input message. 


222~259s 

A WY on a program attempting to perform a DMS open where the 
database is tocked now contains the correct file-identifier in 
the response. | 


(2222504 

Atteapting to print part of the SPO queue (for. sean ar “KB 100°) 
when the SPO queue contains some untnyetaltzes records no longer 
halts the are 


S222 hle 

Due to jeplawentation of the MEMORY.PRIORITY attribute> the MP 
input messager previousty used to tist the Multi-Pack File 
Tables» is now used to interrogate or change the memory priority 
of a program in the mix. The MU input message is now used to 
list the Multi-Pack File Tables. Complete documentation on both 
of these input messages is contained in the revised Software 
Operational Guide. 


2222822 | 

The MCP now properly handles the Working Available Table tf an SD 
input message is used to assign an additional system drives and 
the Working Available Tabte on the existing system disk(s) has 
extension segments- : 
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£el2G3~ a 
It is now possible to interrogate (with the LT input message) 
which print transtator was selected while the printer is in use. 


2222640 

The two methods for accessing 17/0 SEQUENTIAL disk files» first 
implemented in patch #40 to the Mark VI.1 MCP» are atso included 
in Mark VII.0. Appendix C to the revised Software Operational 
Guide contains detailed documentation on all methods available 
for accessing disk files on 8 1800/8 1700 systems. 


Leda Known Errors and Restrictions. 


Lasele 7 
The “INVALID. CHARACTERS=1" option of the FILE statement is not. 
functional. | 


Larzie 

A *CLOSE PURGE" on an untabeled tape aes ‘not works because the 
MCP cannot find a- tape volume-identifier.. This will be 
considered a permanent restriction. 

2ase3e 


The MCP will terminate any program chat attempts to OPEN Coutput) 
a file with odd-length tlogical records on PhaserEncoded (PE) 
tape. Input files with odd-length records are alloweds however» 
caution should be used to insure that “garbage” records are not 
read by the program. This with be considered a permanent 
restriction. . 


Lasahe 

The “retry count™ in the ELOG entry for a nonvuser I/0 Ci-eer an 
I/O descriptor not associated with a File Information Block) witt 
always be recorded as zero. 


£23232 7 

A program atteapting to open a  btocked file on an 80- or 
96-column data recorder will be DS~ed by the MCP. This witt be 
considered a permanent restriction. 


223262 | 

If any system utility program using “Direct I/0" (such as 
SYSTEM/DISK.INIT) is OS~ed»s the drive it was using must be 
readied manuatly (C"RYDCx™” or “RYDPx") to return it to the system. 
This will be considered a permanent restriction. ; 


Ss3ale 


Record count» block counts and cumulative time open is tncorrect 
in the LOG for REMOTE and QUEUE files only. 
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22328 a | 
Jobs still in the schedule when a CLEAR/START occurs are marked 
in the tog as "RS-ED" rather than "ABORTED™. 


rere re am | -. 3 3 

A transferred LOG» ELOG» or SPOLOG file that has only one disk 
area assigned is not reduced in size to eliminate wasted sectors 
at the end of oe area. | 


223210+ 


The MCP fails with unpredictable results if an attempt is made to 
enter an OF message referencing a MICR Reader~Sorter file. 


— Seselde iy Ss 

A *task*® (for example»rp a SORT intrinsic) in the wix is counted by 
the MCP as a separate job when determining whether or not the MIX 
LIMIT has been reached. 


22312. 
It is not possible to KP a PRIVATE file by file-identifier» even 


if the -KP message is prefaced with the appropriate usercode and 
password. 


| 2abslds | a 
Column one of the beginning Label card on an. 80°-column. punch 
output file is not being punched with an invalid character. 


f252h4e | | 

If an ADD» DUMP» LOAD» or UNLOAD message is preceded by a 
USER=<usercode>/<password>» no filecidentifier having a 
family>name may be specified in the fite-name list if the 
family“name is not the same as the specified usercode. For 


example» the following statements are valid: 


US SITE/A DUMP TO T =/=3 
USER=X/Y LOAD FROM TAPE A» Be (X)/C> 


The following statements» however» is illegal: 


USER A/B ADD FROM XXX C/D5 


2232152 7 | : 
If the message “PGMIxsPOMIx" is entered for a Phase~Encoded (PE) 
tape» the tape is unloaded before the purge is done. The next 


tape mounted on the drive will be purged if it contains a write 
ring. 


2232162 | 
The RX tinput message does not remove any files having a _ usercode 
as the family- names even if they are not specified in the 


file-name List. 
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Se3elle | 
Entering a CL input: message referencing a tape unit doing a 
"SPACE" communicate on a multi-file tape hangs the MCP. 


£23218. 
The following SPO input sequence generates “garbage™ SPO messages 
and does not assign the printer pron erny. 


< job-number >FMLPXFEX <program~id> 


£232122 | Bork. | : 

By defaults» the line width for the CRT SPO is erroneously set to 
72 instead of the correct value of 80. A "K8 W 80" is required 
after CLEAR/ START to set the proper maximum line width. 


2232202 | | | | 

If an SDL/UPL program has frozen itself CFREEZE_PROGRAM)» the MCP 
erroneously resets the "freeze" condition if the program does a 
REMOTE file open» This does not occur during other types of file 
opens» nor does it occur if the program was executed with the 
FREEZE option specified. 


NOTE 


In Mark VIII.0>» the FREEZE _PROGRAM/THAW_PROGR AM 
communicate mechanism will be changed. For each 
programs the MCP will maintain an 88-bit “counter™ of 
FREEZE communicates » which witl be bumped for each 
FREEZE_PROGRAM and decremented for each THAW_PROGRAM. 
A program witit be considered "frozen" as long as the 
counter is non-zero. Overflow/underflow is ignored; 
thus» FREEZE_PROGRAM and THAW_PROGRAM communicates must 
be properly matched in order to work as intended. 


Za3aZ1e Ser o} 
The LOCKED message displayed after an SNL input message disptays 


the old tape seriat number cather than the new tape serial 
number e : : . 


Rebe2le 

Attempting to aoaity a code file via an OBJ statement using 
quotes €") and semicolons (3) to delimit paragetens can result in 
various syntax errors. For exaaple: 


COMPILE «2. OBJ FILE <file-itd> PACK.ID=" "#CG 9999999 


£23223 
Relabeling CRL message) the PBD.DESIGNATICN disk CBD message) is 
no tonger allowed. 
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232242 | | | 

' Output printer backup files that have USER.BACKUP.NAME specified 
are not entered in the AUTOPRIAT QUEUE if they are directed to a 
disk other than the PBD.DESIGNATION disk. 


2232232 . oe : 
The RB DMP/= and BF DMP/= input messages do not work correctly 
when the PBD.-DESIGNATION specifies a user disk. 


2232282 | : 
When a disk file is opened INPUT by one or more programs» if 
another program opens the same file 1/70 LOCK ACCESS» a lock bit 
gets set in the disk file header (DFH). When the program which 
opened the file I/0 LOCK ACCESS goes to end-of-job or closes the 
file» the lock bit is not reset. This prevents other programs 
from opening the file until it is closed by att programs. 


Zadetls . ‘ . 

If a file is modified to a nonvexistent unit CUNIT.-NAME attribute 
of the FILE statement)» the program will be terminated if it 
attempts to open the file. 


2232282 | | 
The RX input message requires that a slash (/) separate the 
unit-mnemonic Cor pack~id) and serial-number specifications. For 
example: . 


RX DPA/123456 FILEA» FILEB/FILECe w0- 3 


2232292 | 

The MCP will erroneously reinstate a program if an ST message 
followed by a GO message is entered for that program while it is 
awaiting OS or OP. The results of reinstating the program in 
such a case are unpredictable» and can cause system failures» 
data corruption» and so forth. 


 203230% | & 2 
A program in the schedule which has the NODIF attribute set is 
RS-ed if the parent program terminates abnormally. 


2232312 — 
Attempts to relabel (RL input message) a system pack causes an 
MCP READ OUT“OF“BOUNDS hatt. | 


£232322 3 | 

A COMPILE and GO with an error in any O8J attribute cays@s5 the 
"GO" portion to be RSsed and the temporary abject code file to be 
removed from disk. 
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“PadaS3s 


Any job attempting to open an input file with a RECORD.SIZE equal 
to zero and the DEFAULT attribute reset will be DS-ed. 


2a3s3he | #3 
If two programs are accessing the same disk file and one of them 
closes the file with PURGE» the file will be removed from disk 


when it is closed by the second program (regardless of which 
CLOSE option is specified). 


Sada33s : 
When attempting to call SORT/QSORT with large records» certain 
combinations of sort memory size» number of input records» and 


number of sort keys can cause an MCP “DIVIDE 8Y ZERO" halt 
(L=a00000AQ). 


Temporary fix: Increase the amount of memory assigned for the 
SORT. 
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3e Interpreters and Firmware 


Sail. Introduction. 


The Mark VII.0 firaware contains a number of significant changes» 
most notably pertaining to the new Memory Management algorithms. 


CLEAR/START and SYSTEM/INIT have been redesigned» resulting in a 
different memory tayout fotlowing the CLEAR/START operatione 
implementing the XM functions and providing more information in 
memory dumps. 


The MCP.LEVEL field checked by the MCP at 80J for all programs 
has been raised from 1to 2 for allt interpreters» meaning that 
Mark VII.0 interpreters cannot be retrofitted to Mark VI.l 
systems. In additions Mark VIIe0 CLEAR/START cassettes are 
coapletely incompatible with att other release versions. 


3222 Enhancements. 
3e2ele GISMO 


ae The task of finding a suitable area of memory when requested 
is now a GISMO function. This “FINDWINDOW" procedure’ uses 
appropriate criteria such as availability and memory priority 
to select the precise area to be deallocated. The SMCP>» 
using the tocation and size passed to it by GISMO» is still 
responsible for rolling out any data segments in the area to 


disk. 
b. New Performance Monitoring capabilities, as described in 
appendix B of the revised Software Operational Guide» have 


been implemented in the Mark VIT.0 GISMO. Note that all of 
the performance-monitoring functions require the use of 
GISMO/DEBUG. | 


ce With the exception of console interrupts when the SOL 
Interpreter is in controls all interpreter halts are the 
result of information passed to GISMC» which performs the 
actual halt. 


d- <A problem has been corrected in which GISMO> in certain 
instances» | was incorrectly handling disk pack retry. 
operations with skew and offset» treating them instead as 
verification operations. . 


3aZe22 MICROMCP CMMCP) 


ae The Mark VII.O0 MMCP release has few changes of user 
significance. Certain changes in the MMCP-SMCP interface 
have been made» none of which are visible to the system user. 
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be. <A_ problem invotving the incorrect handling of end-of-tape 
CEOT) on Paper Tape Reader files has been corrected. 


BeZe3e CLEAR/START 


A number of functions have been moved from SYSTEM/INIT to 
CLEAR/START» where they are treated as subprograms by 
SYSTEM/INIT. This causes the physical quantity of tape used by 
CLEAR/START to he noticably longer than that used in the Mark 
VI.1 cassette. Thus» users should not suspect that the computer 
is “running away” when the tape continues to turn beyond the 
customary point. . . . 


NOTE 


Depressing the CLEAR button when | beginning a 
CLEAR/START destroys the TAS pointer in the processor. 
It is therefore essential» when taking a memory dump 
after an uninterruptible system loop Cone for which the 
HALT button must be depressed to stop the processcr) 

that the contents of the TAS register be recorded 
before doing | the CLEAR/START. Likewise» for 
uninterruptible hangs» the user is urged to record FA 
and F8 as wetl as the registers requested on the dump 
(Lo Ts Xe Ye and A» plus MBR and TOPM on 1720 series 
processors). Interruptible loops (those which are 
halted by the INTERRUPT switch) become defined halts 
for which no additional information must be obtained by 
the system operator when taking a dump. 


Be2ehks System Initializer CSYSTEM/INIT) 


ae SYSTEM/INIT is now Loaded over GISMO in memory» if one 
existed? otherwise» it is loaded in mid-memcry- This allows 


the interrupt queue to be printed in memory dumps» whereas in 
past releases this information at the top of memory was wiped 


out by the toading. of SYSTEM/INIT. In many casese this 


perwits diagnosis of system hangs caused by faulty 1/0 
controls generating bad interrupt entries. 


bi The A Stack and processor scratchpads are now extracted by 
| SYSTEM/INIT and included in SYSTEM/DUMPFILE for printing by 
MCPII/ANALYZER.} . . 


Ce SYSTEM/INIT now loads GISMO beyond the SMCP LIMIT.REGISTER 


rather than in low memory» providing greater protectfan fran 
accidental corruption. ; 


d. The XM functions which Links areas out of available memory» 
has been coded in SYSTEM/INIT. 


e- The @emory duap functions previously performed by 


SYSTEM/MEMDUMP are now done by SYSTEM/INIT. SYSTEM/MEMDUMP 
is» thereforer no longer released. 


29 


Sa2e32 SDL Interpreter 


No eajor changes have been made to the Mark VII.O SDL 
Interpreter. 


g22265 COBOL Interpreter 


“No @ajor changes have been made to the Mark VII.O COBOL 
Interpreter. 


 Ba2eZe BASIC Interpreter 


No major changes have been made to the Mark VII.0 BASIC 
Interpreter. 


322282 RPG Interpreter 


The divide algorithm in the RPG Interpreter has been optimized» 
improving the speed of divide and square root operations. 


322292 FORTRAN Interpreter 


The addition of new code in the Mark VI.1 FORTRAN Interpreter 
pushed the code used _ for double~precision handling beyond the 
MeMEMORY»MINIMUM point. This had the unintentional effect of 


degrading per formance of programs making heavy use of 
double-precision functions on a 81720 processor having 4KB_ of 
Control Memory. The Mark VII.O0 FORTRAN Interpreter has been 
somewhat rearranged to return the double~precision code to 
Control Memory>s thus restoring the originai speed of such 
progr amSe : 


3.3- Known Errors and Restrictions. 
(3.321- SDL Interpreter 


ae The SDL Interpreter is incorrectly checking for field 
overflow beyond the 65°535-bit maximum Length capability of 
SDL/UPL when performing X_ADD and X_MUL operations. This can 
result in erroneous “NAME/VALUE STACK OVERFLOW" errors 
instead of the desired "EXPRESSION OUT OF RANGE* errors Note 
that this limit applies to the temporary area in the VALUE 
STACK in which the result is formeds the length of the field 
in which the result is ultimately stored is irrelevant. 


be A CLEAR of an array of type RECORD produces incorrect 
results. . 


ce The LENGTH functions when applied to an item of type RECORD- 
returns the length in characters rather than bits. 


33022 FORTRAN Interpreter 


ae The CSIN (Complex Sine) intrinsic produces results with 


incorrect sign of the reat part in certain cases. 


b. If a portion of an array is passed to a subprograms 
turn passes a still smaller portion to a second subprograms 
the FORTRAN Interpreter in certain cases attempts to access a 
nonexistent data segments resulting in program termination. 


3s4s Interpreter Verification Attributes. 


SOL_ Interpreter (SOL/INIERPIM and SDL/INIERP 15) 


ARCHITECTURE. NAME: "SDL" 

COMPILER.-LEVEL: 1 

MCP.LEVEL: 2 

GISMO.LEVEL: 2. 

ARCHITECTURE-ATTRIBUTE bits that are TRUE: 
2e 30 4e Se be Fo Be 10% lis 12» 13. 

Segments: 13 


COBOL Interpreter (COBOL/INIERPIM and COBOL/INIERPIS) 


ARCHITECTURE.NAME: “"COBGL” 

COMPILER.LEVEL: 1 

MCPeLEVEL> 2 ~ 

GISMO-LEVEL: 2 

ARCHITECTURE .ATTRIBUTE bits that are TRUE: 0 
Segments: 4 


RPG_Interpreter CRPG/INTERPIM and RPG/INTERPIS) 


ARCHITECTURE .NAMES *RPG" 

COMPILER.LEVEL: 1 

MCP.eLEVEL: 2 

GISMO.LEVEL: 2 

ARCHITECTURE-ATTRIBUTE bits that are TRUE: O» lr 2» 
Segments: 7 


BASIC Interpreter CBASIC/INIERP3M and BASIC/INTERP3S) 


ARCHITECTURE .~NAME: “BASIC” 

COMPILER.LEVEL: 3 

MCP-LEVEL: 2 

GISMO.LEVEL: 2 
ARCHITECTURE-ATIRIBUTE bits that are TRUE? None 
segments: 1 


3» 


| fa 


FORTRAN Interpreter (FORTRAN/INIERPIM an 
N 


ARCHITECTUR EeNAMES *"FORTRA 
COMPILER.-LEVEL: 1 
MCP.LEVEL: 2 

GISMO-LEVEL: 2 
ARCHITECTURE ATTRIBUTE bits that are TRUE: O» 1 
peanents: 1. 


B500 Interpreter (B8500/INTERP2U) 


ARCHITECTURE .NAME: "B500" 

COMPILEReLEVEL: 2 

MCP.LEVEL: 2 | 

GISMO.-LEVEL: 2 Sg 
ARCHITECTURE. ATTRIBUTE bits that are TRUE: None 
Segments: l 


IBM 1400 Interpreter (1400/INTERP2U) 


ARCHITECTURE .NAME>S "1400" 

COMPILER-LEVEL: 2 

MCP.LEVEL: 2 

GISMO-LEVEL: 2 

ARCHITECTURE .ATTRIBUTE bits that are TRUE? None 
segments: 1 


GISMO_(GISMO_and GISMO/DEBUG) 


GISMO.LEVEL: 2 
ARCHITECTURE-ATTRIBUTE bits that are TRUE: 

le 30 21s 225 239 hls 420 Tle 738 THs 752% 76 
segments: 1 


MICROSMCP-CMCPII/MICRO-MCP and MICRO.MCP/DEBUG) 


ARCHITECTURE. ATTRIBUTE bits that are TRUE: 
le 32 215 220 23% 20% 43» 4ho 45% S2e 53 
TO» 71x 73% 75» 772 79 

Segments: 16 


—~EORTRANZINTERPIS) 
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4. RPG 


hele Introduction. 


The Mark VII.0 release of the RPG compiler includes corrections 
to outstanding problems» the capability to mairtain a Library of 
source fites» and increases the maximum number of files allowed 
in an RPG program. Each of these changes is documented in_ the 
paragraphs that follow. 


hage Enhancements. 


Segehs : 
The following problems reported in the Mark VI.1 release letter . 
have been corrected (the numbers in parentheses refer: to the 
paragraphs in the Mark VI.1 release letter which originally 
described the problem): : 


ae Right«signed numeric fields written to a printer file no 
tonger have their sign fields replaced with an "F" (4.3.2). 


be. The RPG compiler no tonger terminates with an INVALID 
SUBSCRIPT error when the File Specification card has 
entries shifted to the lteft (4.3.6). 


Ce Sequence checking is now performed for compile-time tables 
and arrays when ascending or descending sequence is 
specified (4.3.12). 


4elede 


The *X* edit code has been anerecied to remove cnty the positive 
sign. 


422230 | 
An RPG program sei more than 64 arrays declared no Longer 
terminates with a WRITE guT- OF ~BOUNDS error. 


bedede : 

When using the *MOVEL® operation to move a ‘smaller humeric field: 
to a larger alpha field» the sign is placed ih the zone position 
of the rightmost character moved. For examples "MOVEL® of 
"=-6789" to a field containing "ABCDEFGH* will give the resutt 
*67BREFGH* (R represents 9). 


hededs 
The RPG compiler now supports source file maintenance. Refer to 
paragraph 4.4.2 for temporary documentation on the SYNtaXe 
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4e228e 

The RPG compiler no longer terminates with an INVALID SUBSCRIPT 
error when a constant in Factor 1 or factor 2 of the Calculation 
Specifications contains a 9° argue fietd followed by a decimal 
point. 


4etels . . . . 
The RPG compiter will now syntax null constants (two single 
quotes on a line in the Output Specifications). 
422286 | 
The RPG compiler will no longer terminate with an INVALID CASE 
error under the following conditions: 

ae A "Z"“ADD" operation is to be performed» 

b. Factor 2 is a literat with decimal positions declared» and 


ce The result field has zero decimal positions dectared. 


4e2eI9e he, | , 
The divide algorithm in the RPG Interpreter has been optimized. 
The new interpreter improves the speed for division when: _. 

ae Each operand is less than six bytes in length» or 

be There are leading zeros to the left of the decimal pointe 


Square root operations have also been significantly improved. 


4o2s10s 

When compiling with switch 1 set to Il» a printer fite catted 
"ERRORLINE® will be created» containing any syntax errors or 
warnings detected in the compiled RPG program. The MCP 


automaticalty appends a "SW1=1" attribute to any COMPILE control 
instruction zipped with a session number. between 1 and 1023» 


inclusive (for examples a COMPILE performed through CANDE). 


S4egells . 

A warning witl .be generated by the RPG compiler when the value 
for "S$ RPERA® is not an even multiple of the records per block. 
The RPG compiter will automatically adjust the sizes upward ag 
necessary ; © Ms ; 


4efelze : | 
The RPG compiler has optimized the addition of records ¢£Q an 
indexed files especially when the records are added in order. 


4222132 oe 
Input Specifications no tlonger have to repeat the decimal 
positions for numeric arrays. 
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Leese Cry 
Multiple Controt Card Specifications will now be given a syntax 
error. 


Se2e122 4! 
Matching record and controt tlevet indicators are no longer 
required to be in the first input field declared by a group of 
consecutive field record relation tndicators. 


4e22216s 
"S$ NAMES" no tonger generates two copies of the ™NAMES™ Listing 
when there are syntax errors. 


heatelfles _ 

A warning is now generated by the RPG compiler when the "71P" 
indicator occurs on an exception or total tine with "AND" cr "OR" 
specified. 


4eZe18e | 

A syntax error is now generated by the RPG compiler when the 
“FROM FILE" fietd is specified on an Extension Specifications 
line and the “ENTRIES PER RECORD” field is left blank. 


4o2219- | | ee tae 

A syntax error is now generated by the RPG coapiter when the 
floating dottlar or check protect signs are encountere?, with the 
edit codes "X"%» “Y¥", or "Z". 


4222202 


Alt known Line skipping. problems with RPG I have been corrected. 


hefeZle 
The RPG compiler now correctly handles output cata files when a 
"B" is entered in column 16 of the Control Card Specification. 


hoteles _ 

The RPG compiler now correctly handles arrays and tables when the 
elements are larger than 256 bytes and when the array or table is 
declared as being ordered. 


4o22232 
The RPG/BTIF program has been enhanced to be more compatible with 
the RPG compiler. The enhancements are as follows: 


ae The internat file name for the input card fite is now 
"CARDS" instead of "SOURCE. . 


be The DEFAULT file-attribute bit is now set. 
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Levers) : | 

Line skipping is now performed correctly for programs compiled 
with RPG I. For example» if the line printer is on line 5 and a 
skip to line 5 is requested» then a skip is not performed. 


 Aadelds 
A channel 12 punch in the carriage control tape for tine printers 
is now allowed when using SYSTEM/BACKUP. 


4232 Known Errors and Restrict ions. 


hededs oo 

A modify of the PACK.ID ‘be indexed"sequential update files with 
additions is not forwarded to the RPG/REORD program» since the 
file information used by RPG/REORD is the result of a 
compile-time interface function. This restricts RPG/REORD to 
using the file information specified at compile time. For 
‘improved performance and flexibility» it is suggested that the 
standard SORT. be used instead of RPG/REORD by removing att 
*¢ REORG” cards. 2 . | 


4e3n2s | 
The "Y¥" edit code now only operates correctly on a field with 
four or six characters. A packed field implies a sign. 


423232 

~The RPG compiler does not syntax a “SETOF* operation code that 
turns off the tast record (LR) indicator. The results can be 
unpredictable if used. 
4234s , a | 
Due to the tag file naming conventions RPG indexed=sequential 


files cannot be used when executing under the file security 
system Cunless executed under a privileged usercode/password). 
"B®"-indexed files are not affected by the file security syster 
even when executed under a non-privileged usercode/password. 


hadade 7 
Source file maintenance of compile-time vector data is not 
possible. : . 


423262 
Tape files are not closed with RELEASE when the TAPE REWIND 
field» column 70 of the File Description Specificationss 1s left 
blank. 


hedols 
The "TESTZ*" operation does not test the zone position of numeric 
fields. 
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Sa5eBe | 
The "TESTN®™ operation is not a valid command for the Mark VII.-0O 
release of the RPG compiler. . 


a3.95 | 43 | | 

A Fs" or "1" in column 21 of the Control Card Specifications and 
a "1" edit code in cotuan 38 of the Output Specification yields 
"200" for a zero value instead of "000". 


4e32102 a: 

The RPG comptler generates two syntax errors when a null constant 
(two single quotes) is encountered in the Output Specifications. 
The syntax error message “INVALID CONSTANT SIZE" is correct; 
howevers the syntax error message “INVALID ENDING POSITION” is 
incorrect. 


423211: ; | | | 

A variable with a value of zero and decimal positions dectared 
fills asterisks only to the left of the decimat point when the 
“K" edit code and the "«" check protect symbol are specified. 
The result should be asterisk fill in att positions. 


423 122 | 
The RPG compiler terminates with: an INVALID SUBSCRIPT error when 
the tag name referenced by a "goto" operation begins in column 34 
instead of column 336 


423-13- 


The RPG compiler generates the following syntax error when the 
result field length of a “MVR*® operation is greater than the 
length of the field specified in Factor 2 of the previous "DIV": 


RESULT FIELD LENGTH FOR MVR MUST EQUAL FACTOR 2 FOR PREVIOUS DIV 


4232140 . 
An RPG program wil eseeinake with an INVALID SUBSCRIPT error 


when a Calculation Specification contains the following: 


ae "MOVE® in the Oper ation field» 
be. A subscripted array Cnumeric) in Factor 2, 


c. The subscript of the subscripted array cSPgee ines in Factor 
2) is entered in the Result Field» and 


d- The numeric value of the subscripted array which is heing 
moved is larger than the Entries Per Array specified on the 
Extension Specifications. 


For exampler if the array "ARR®. has 10 elements and ‘ARR»X* 
equals Ills ‘then ‘MOVE ARR»X (Ctod KXK* results tn an INVALID 
SUBSCRIPT error. 
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4edelis 


The RPG compiler. generat és incorrect code under the folttowing 
conditions: 


de 


be 


The elements. of a dynamic vector are described Cin the 
Extension Specifications) as unpacked numeric with a tength 
that is an even nuehers of bytes» and 


‘The vector is described as packed in the Input 


Specifications. 


Vectors having a length that is an odd number of bytes generate 
correct code. 


4ehe 
— heholds 


The 


Temporary Documentation. 


Number of Files 


maximum number of files that may be declared in an RPG 


program has been increased to 31. Each indexed fite and its 
associated tag file counts as one file. 


hehe2de 


The 


Source Fite Ral erenance 


following dollar card options may appear anywhere within the 


B 1800/B ree source file: 


$ CHECK Causes atl patching records to be sequence checked. 


Syntax errors are generated for any patch record that 
is out of sequence. If the “$ CHECK" option is not 
specified» then sequence warnings are issued. The 
warning ts denoted by an "S" appearing to the left of 
the sequence number on the output listing. 


$ MERGE Causes the following records in the patch file to be 


merged with an existing source file. The source file 
is expected to reside on tape or disk (disk by 
default)» and has internal and external file names of 
"SOURCE™. The DEFAULT file attribute is set. 


If it is desirable to change the external file name 
or input device from disk to tape» then a FILE 
control card must be used. The "$3 NEW" option can be 
used with the "$ MERGE™ option to create a new output 
source ‘file with patches. 


The eanuonee fields are used to control the merge 
sequence. If the sequence fields of a patch record 
and a source record match» then the patch record 
replaces the source records otherwise» patch records 
are merged with the tape or disk file. The existing 
source file remains unchanged. 


$ NEW 


$ SEQ 
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A "P" is appended to the Left of the sequence” field 
on the source listing to indicate that the image is a 
patch record. 


Creates a new output source file. If the "“$ MERGE" 
option is used» then the patches are included in the 
new source file. The new source file is created on 
disk or tape (disk by default)». having internal and 
external file names of “NEWSOURCE*. If it is 
desirable to change the external file name or output 
device from disk to tangs then FILE control cards 
must be used. - 


Starts sequencing the subsequent source Lines on the 


output Listing. If the "S$ NEW" option is used» then 


the subsequent new source file is sequenced. The 
starting sequence number. begins with the number 
contained in the sequence fietd»s columns 175+ of the 
"$ SEQ" option. If the sequence field is blanks» then 
the starting sequence number is zeraoe The subsequent 
records have sequence numbers which are incremented 


by the value contained in cotumns 22724 of the 


"S$ SEQ" option. If columns 22°24 are blanks then 010 
is assigned. : 


The following options may appear anywhere within the 
B 1800/8 1700 RPG source programe These options direct the 


coapiter 


perform specific source file maintenance functions. 


ALL of the TOC bow nny: options may be eeeets 


$ LIBR 


$ NEWID 


Copies source records from a library file located on 


tape or disk to a new or merging file. The $ LIBR 


option can. reference different  tibrary files. 
Columns 15°24 contain the pack-id» columns 25734 the 
familyonames columns 35-44 the filesid» columns 45°49 
the starting sequence number in the library file 
Coptional)» and cotumns 50°54 the ending sequence 
number in the library file Coptional). 


An "LL" is placed to the left of the sequence field in 
the output Listing to identify that the record is 
from a library source file. 


Causes the 6-character identifier specified in 
columns 15°20 of the "$ NEWID" option card to be 
placed in columns 75°80 of the subsequent lines on 
the output Listing. if the *$ NEW" option is used» 
then the specified identifier is atso placed in 
columns 75°80 of the subsequent source records ir. the 
new source file. 


$ VOID 
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Deletes records of the source file on the output 
Listing. If the "$ NEW* option is used» then” the 
deleted records are not included in the new source 
file. Source tines or records are deleted up to and 
including the S-digit void limit. If the void limit 
field» columns 20°24 is blank» then only the source 
record with a sequence number matching the sequence 
field of the "$ VOIO" option card is deleted. 
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S- COBOL 


Sel. Introduction. 


The Mark VII.0 release of the COBOL compiler includes the syntax 
for "OPEN EXTEND" for sequential disk files» corrections for 
several problems found in prior releasess and Burroughs 
extensions to the "AT END™ and "INVALIO KEY" clauses for the 
Indexed 1-0 Modute. | 


Sege Enhancements. 


Q22e1- . ; 

The following problems reported in the Mark VI.1i1 release letter 
have been corrected (the numbers in parentheses refer to the 
Paragraphs in the Mark VI.1 release tetter which originally 
described the problem): 


ae The compiler now checks the amount of dynamic memory during. 
BOJ» and aborts immediately if less than 18000 bits is 
assigned (54347). , 8 : 


b. "WORKING-STORAGE SECTION" is now optional with or without 
"DATABASE SECTION" (5.3.14). a 


Ce. Misspelling or omitting "INVOKE" no Longer causes. “NO 
PROVISION FOR EOF ON DONINFO" during compilation (5.3.18). 


de "DISPLAY <edited-field>" = now generates correct code 
(5.3-25).- : 


e. The message concerning “INSUFFICIENT DYNAMIC MEMORY? is now 


printed at the end of the listing» as well as being 
displayed on the SPO (5.3.33). a 


f. The "TAG*SEARCH® option of the "SORT" statements» when used 
with J-signed keys» now generates correct code (5.3.36). 


ge A file assigned to "CARDI6™". now generates the correct 
hardware type (5.3.38). 


he A "PERFORM eee VARYING «2+ AFTER awe” “statement Now sets 
the "FROM" datawname to its “current™ value rather than its 
"initiat"™ value (523-39). 


222222 2 

"COMPUTE C = <expression>",», where C is too small to hold the 
result and no “QN SIZE ERROR" clause is specified» now results in 
left digit truncation instead of program termination. 
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522035 7 
The statement "COMPUTE A= 1+ B/(C * 4)" no longer. causes’ the 
divisor and dividend to be reversed. 


Se2e4e o | : 
Multiple “USE” procedures for a file without an "INVALID KEY* 
clause on a READ or WRITE no tonger causes compile-time errors. 


Se2e5e | | | : 
An embedded data set immediately preceded by a-— group or 
elementary tevel with an “QCCURS"™ clause no longer causes the 
compiter to abort. 


222252 | 
The file m ERROR « LINE" is now unblocked. 


aelele | | 
Correct code is now generated when both data segmentation and 
ISAM are used in the same program. 


COBOL ISAM programs without a WRITE statement no tonger cause an 
"INVALID SUBSCRIPT" error pee execution. 


222022 rt 

For Indexed files» the tag file is now able toa contain as many 
records as its related data file. Refer to paragraph 5.4.8 for 
further information. 


2222102 
Erroneous “DUPLICATE NAMES® syntax errors no tanger occur when 
the dynamic memory allocated to the compiler is tess than: 


Cthe nuaber of explicit data names + 2) «a 38 


Q22ell- | 
The statement “COMPUTE A = B CN SIZE ERROR™> where B is smaller 
in size than A now generates correct code. 


2elal2s 
Erroneous “PICTURE TABLE FULL™ syntax errors no longer occur when 
the number of unique pictures is greater than 255. 


2e2e2h3- : : 

A WRITE OUT*OF-BOUNDS” or “INVALID SUBSCRIPT" error no Longer 
occurs when a file named in a “"“MERGE"™ statement has a 
“VALUE OF ID IS datasname” clause. 

a2asel4des 


An 170 verb within an "INVALID KEY” clause no longer causes an 
"INVALID SUBS TRENG® perPS compilation. 


42 


2222152 | 
The "EXTEND" phrase has been added to the COBOL syntax for. the 
OPEN statements» as follows: 


i ! 
{ OPEN t 
[+ Sse ! 
1 : | 
I { EXTEND filesnamer~i € WITH LOCK C€ ACCESS 131] #1 
iar ara ee ! 
1 ! 
| C file~name-2 coe ] J ave 1 
( t 


Refer to paragraph 5.4.1 for further information and examples. 


2ahalbe , 
"SEARCH eee WHEN w22"% may be terminated by a conditional or 
compiler-directing statement» as well as an imperative statement. 


Qerells : . ‘ ; 

“OPEN filesname ACCESS" is now syntaxed correctly. 

222218. 
“DISPLAY Z9.9" now includes the last character in the display. 
222219. 


The compiler ignores all except the Last "BLOCK CONTAINS” clause 
when multiple “BLOCK CONTAINS" ctlauses are used in a File 
Description (FD). . 


3222200 7 7 a 
"PERFORM wee VARYING ~--” nested deep in an "IF wee ELSE «2 2” 
statement is now syntaxed correctly. = 


22222h- | 
The compiler can now handle up to 9999 errors and warnings to be 
printed at the end of the Listing. : 


2eLeles | 
ISAM subroutines are now segmented. Refer to paragraph ‘3eh.t1 
for further information. 


2elel5s : : 
COBOL/XREF now recognizes. $ and picks up library COPY statements 
with embedded spaces. 
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2232 (Known Errors and Restrictions. 


22321. 

A subscripted reference where the subscripts are numeric literals 
causes a syntax errors “LITERAL SUBSCRIPT CAUSES OUT OF BOUNDS 
ERROR» if the compiter catcutltates an address that exceeds the 
boundary. Therefore» it is possible to exceed the "OCCURS*™ count 
and not receive a syntax error. For example: 


Ol As: +. | 
03 B OCCURS 5 TIMES. 
05 C OCCURS 10 TIMES PC X. 


C(Se1l1) will receive a syntax error. 
CC211) will not receive a syntax error. 


Sa5a2e 


An “OPEN INPUT™ on a printer or punch fite is not syntaxed. 


223232 ees | | 
A COBOL erourens is unable to inquire as to the presence or status 
of a disk file. 


Peers 3) : 
A file declared "OPTIONAL" is not being syntaxed if opened 
OUTPUT. . . 


223222 _ 
During sean ineteni it is not possible to call the COBOL/XREF 
program by a dollar option. 


22328: | 

In order to compile with COBOL on a system having a memory size 
of 48K8 or lessee the following modifications to the compiler 
should be made: . 


? MODIFY COBOL 


? FILE NEWSOURCE AREAS = 10 BUFFERS = 13 

? FILE LIBRARY AREAS. = 10 BUFFERS = 13 

? FILE REPORT AREAS = 10 BUFFERS = 13 | 

? FILE ALLDNOUT AREAS = 10 BUFFERS = 1 RECORDS-BLOCK 13 
? FILE ONFILEX AREAS = 10 BUFFERS = 1 RECORDS.BLOCK 13 
? FILE ADNFILE AREAS = 10 BUFFERS = 1 RECORDS-BLOCK 13. 
? FILE ADFILE AREAS = 10 BUFFERS = 1 RECORDS.BLOCK 13 
? FILE SEGFILE AREAS = 103 

? FILE CARDS BUFFERS = 13 

? FILE SOURCE BUFFERS = 3 

? FILE LINE BUFFERS = 135 
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In additions a MEMORY card should be used at compile time: 


? COMPILE <program=id> COBOL LIBRARY MEMORY = 18000 
2? DATA CARDS 

<source cards> 
2? END 


Dynamic memory must not be modified permanently in the compiler. 


Q232ls | 
The compiler does not check for correct spelling of the word "IS" 
in a "VALUE OF ID IS" or a “DATA RECORD 15S" clause. 


223282 


Reserved words used aS datasnames may cause compiler loops. 


223222 | 
It is not possible to specify the number of Lines allowed per 
page on the compile Listing. ie 


223210. 

The *"TIME®* option does not return the time in tenths of seconds. 
Q2selle 

"READ" statements are unable to perforn stacker selection. 
J2edel2s 


The coapitlation date/time does not print on the same Line as the 
“DATE“COMPILED™ Statement. 


— Badel5e 
“MONITOR®™ overprints the last print file tine when printing the 
first monitor line of a page. 


2eseh4- 


"WRITE datasname-l FROM datasname-2" does not result in a 
"RECEIVING FIELD TRUNCATION® warning if the size of data-name=-2 
exceeds that of datatname~1. 


2edalis | 
The coapitler will fail with a "READ ouT-OF- BOUNDS” when cdmbiting 
with many condition-names and insufficient dynamic memory. 


22d2hbe : | | 
 MREMARKS eee" coded in column 12 following a “DATE-COMPILED" 
statement causes an incorrect "MISSING PERIOD" syntax error. 


2eselle 
In some cases» dollar options may be put nto effect Eaters they 
appear in the source. 
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223218 | 
The word "KEY" in a COMPUTE statement is treated as a noise word 
instead of being syntaxed. 


223219 , a 
Compares of computational items to non-numeric literats are not 
being syntaxed. | 


2252202 | . 
The editing symbols "#* and "-" do not function correctly if the 
fietd to be edited contains minus zero. Note that minus zero can 
only result from input or truncations not from arithmetic 
operations. . 


2232212 , 
There are several problems concerning the placement of a syntax 
error message together with its related source statement. 


2232222 
A missing period in a “MODIFY .«+ VIA eee" statement -may cause 
all succeeding paragraph~names to be flagged as duplicates. 


323223 


“DUMP <edited-fietd>” generates incorrect code. 


2232240 . 
The “FILE CONTAINS" clause is not syntaxed for number of areas 
Gr eaTer than 105. 


5232252 | ee) 2 ma | 
The compiler fails with "INVALID SUBSCRIPT" on the following 
condition: ; 


IF CA * (10 ** (2-B))) > 9999999 OR < -9999999 GO TO Cc. 
2239226 


The appearance of an Sawetehes and ipeupecesu "DATA™ in the "DATA 
DIVISION" may cause a “NO PROVISION FOR EOF ON ODNINFO" during 
compilation. 


223227 — 
When "VALUE IS HIGH“VALUES" is specified» the sign of a "signed 
computational" item is incorrectly initiatized. For example: 


ABC PIC S99 CMP VA HIGH"VALUES. (initialized as 39902) 


223228s 


Multiple receiving fields on a “READ --- INTO «2-"% are ~=not 
syntaxed. . 
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22d2222 : | | 
The appearance of the character 27823 in a Literal may cause 
erroneous syntax errors. 


2232302 . | 

Attempts to create library files may be  syntaxed when 
"DECIMAL“POINT IS COMMAW is specified and a period follows the 
Library~name.e Note that the period is not required. 


Preere so 
Use of a *MONITOR™ statement with names of 30 characters in 
length may cause compiler errors. 


5230320 | 
The statement “ADD “literal @avasiewet GIVING datatname-2" loses 
the minus sign for the literal. 


Pre rere 
Referencing sULeiots: files by a single “CLOSE statement in some 
cases is syntaxed erroneously. Note that: 


CLOSE Ar By C 
generates the same code as and is no more efficient than: 
CLOSE A» CLOSE Bs CLOSE C 


2232342 
The statement “WRITE «2. BEFORE <n> LINES" ae allows vatues for 
<n> between 1 and 63» inclusive. 


Prerere | 
"$ CODE" before the final paragraph in.a program causes code _ to 
be generated for the entire program. 


2232362 | 
"DIVIDE A INTO 8 GIVING B REMAINDER Cc" gives incorrect results 
for C. 


2232302 

The error message regarding data Length Limit does not state the 
correct problems which is that the limit onty pertains to FILE 
SECTION entries and referenced WORKING“STORAGE SECTION entries. 


2232382 

"<datacname> PIC Sv¥999 VA 0." causes a "RECEIVING FIELD 
TRUNCATION" warning message to be printed. 

2232392 


The compiler syntaxes 88 Levels in OMS descriptions. 
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2232402. 5 
"GO TO #INV KEY RTN&#.” causes the compiler to loop in PARSE. 


22sc4ls | . eo ioe 
Misleading syntax errors are produced when the continuation of a 
DMS statement begins prior to column 12. 


2232422 | 
WPREAD eee INTO «22% works incorrectly if the first defined record 
for the file being read is smatter than the actual record size. 


223243 . 
Inclusion of a second "FILE SECTION" is not syntaxed and causes 
multiple uses of the same File Parameter Block CFPB). 


2232442 ) 
At execution time an “INVALID TYPE IN COMMUNICATE MESSAGE 
POINTER" error occurs when using "$ NOCOP™ and ISAM files. 


2232432 a | 
An 88 level with both numeric and non-numeric literals is not 
syntaxed. _ 


223246 | | ae 

The statement "IF C- data-namer1) GREATER data~namew2 -.-" 
sometimes causes an “INVALID SUBSCRIPT™ during compilation. 
22r2hZe 


"SEGMENT“LIMIT IS <integer>" is not syntaxed for the hyphen and 
<integer> is not used. 


2232482 | | 
Syntax errors #161 and #337 occur when the datasname in a 
"VALUE OF ID IS datatname™ clause is a RENAMES operand. 


2232490 
A "WAIT" statement immediately followed by a monitored tabet 
generates incorrect code (a zero length literal). 


2232202 

The statement "COMPUTE A = 8 ** CCI J)" causes a “FIXUP COMPILER 
ERROR" message» if it is the first exponentiation encountered in 
the source file and “C" is subscripted. 


2edsdla 
A missing quote in a COPY statement causes the compiler to abort 
with a "NO PROVISION FOR EOF ON ALLDNOUT™ message. 


2232522 

The compiter currently allows more than one data base to be 
invoked in a single program» causing unpredictable results during 
execution. 
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2282250 


The nesting of DMS verbs may cause the compiler to abort with a 
NAME/VALUE STACK OVERFLOW. 


523254 . | 
An ISAM file with “VALUE OF ID IS datasname™ is not syntaxed and 
does not function properly at run time. . 


3232550 


The following statement generates code that reverses the sivederia 
and divisor: 


COMPUTE A ROUNDED = 8 - C - (D * (B - C)) / 100. 


The following statement» however» functions correctly when the 
extra parentheses are used: 


COMPUTE A ROUNDED = B - C - CCD * (B = €)) /# 100). 


3232562 
Moving a data=name to itself» where the receiving field contains 
"BLANK WHEN ZERO"» results tn the entire field containing zeros. 


52305] 
The use of paragraph names instead of section names with the 


"SORT" verb is not syntaxed and at run time does not function 
properly. 


2232392 | 3 . 

If the Labet names in a "GO TO ..2. DEPENDING ON" statement are 
separated by commas» then the last label name must he followed by 
a commas or no code generation takes place. 


2232222 
In the statement “SUBTRACT 1 FROM Literal", the literal is not 
syntaxed and Causes the compiter to abort with "WRITE 


OUT“OF “BOUNDS”. | 
Temporary fix. Replace the literal with a data~name. 


5052600 a8 7 : a 
When the number of "o1 ledats exceeds 127» deasecound addressing 
and run-time failures occur. 


2asehle 2 | 
The statement “EXAMINE datasnmame REPLACING LEADING SPACE." is 
incomplete», but is not syntaxed. 


2232620 
A MOVE of “LOW"VALUES" to a subscripted datasname whose picture 
ts CMP"3 causes a “FIXUP COMPILER ERROR™. 


2ads 
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Temporary Documentation. 


Sesele OPEN EXTEND 


The 


"EXTEND® phrase can only be used with sequential disk files. 


When the "EXTEND" phrase is specified» the "OPEN" statement 


‘posi 


tions the file immediately following the last. Logical record 


of that file. Subsequent “WRITE” statements referencing the file 


add records to the file as though the nite had been opened with 
the *OUTPUT* PNEases 

Example: 

In the following COBOL program segment» assume that the _ files 


FILE“A and FILE"B are disk files: 


* 


+e 6+ te h 


O1 IX PIC 99 VA 0. 


WRITE“FILES. 
ADD 1 TO IX. | 
WRITE RECORD@“A FROM IX. 
WRITE RECORD“8 FROM IX. 


MAIN“CODE. 


OPEN OUTPUT FILE“Ae FILE“B. 
BOTH FILES ARE OPENED AS "NEW" QUTPUT FILES 
PERFORM WRITE“FILES 6 TIMES. 
CLOSE FILE“A LOCKs FILE-B. 
FILE“A IS CLOSED AND ENTERED IN THE DISK DIRECTORY 
FILE-B IS CLOSED ("TEMPORARY™)s NOT ENTERED IN THE DISK DIRECTORY 
THE CURRENT RECORD POINTER IN FILE"B IS RESET TO RECORD 1 
AT THIS POINT,» THE FILES CONTAIN THE FOLLOWING RECORDS: 
FILE-As CEOF=6) O1 O02 03 O04 O05 C6 
FILE-B8: CEOF=6) O01 O02 03 O04 O58 06 
OPEN OUTPUT FILE“A» FILE“B8. 


* FILE-A IS OPENED AS A "NEW" OUTPUT FILE 


* * * © *% , 


» 


* 2 * & 


FILE“B 1S RE“OPENED» ALLOWING EXISTING RECCRDS TO BE OVERWRITTEN 
PERFORM WRITE-FILES 4 TIMES. 
CLOSE FILE-A REMOVE» FILE~B LOCK. 
BOTH FILES ARE CLOSED AND ENTERED IN THE DISK DIRECTORY 
AT THIS POINT» THE FILES CONTAIN THE FOLLOWING RECORDS: 
FILETA: (CEOF=4) O7 O8 OF 10 
FILE"8s CEOF=6) O7 O08 OF 10 05 06 
OPEN EXTEND FILE“A» FILE~B. 
THE EXISTING FILES ARE RE-OPENED OUTPUT» AND THE CURRENT RECORD 
POINTERS ARE POSITIONED TO THE END OF THE FILES 
PERFORM WRIVE"FILES 4 TIMES. 
CLOSE FILE“A REMOVE> FILE-B REMOVE. 
BOTH FILES ARE CLOSED AND ENTERED IN THE DISK DIRECTORY 
AT THIS POINT» THE FILES CONTAIN THE FOLLOWING RECORDS: 
FILE7A2 CEOF=8) O11 O02 03 O4 11 £2 13 «14 
FILE-B: CEQF=10) 01 O02 O03 04 O5 068 11 #12 #13 «14 
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Seakta2e DIVIDE 


The use of "MOD" and "REMAINDER™ in the same DIVIDE verb is 
prohibited and a syntax error is generated. 


Se4eds HIGH“VALUES» LOW-VALUES» and MOVE ALL 


The table below summarizes the actions currently taken by the 
compiler» and points out several inconsistencies and known 
probleas. The first two columns represent the initialized values 
assigned by the "VALUE" clause in the DATA DIVISION and the 
remaining columns show the values after the "MOVE" statement. 


PICTURE 7 Xx 22 229 22 CMP 599 CMP 
VA HIGH“VALUE  FO9FS F9F9 FOF 9«« 99 990« 
VA LOW"VALUE 4040 4040 . 4040** 00 000*«* 
MOVE HIGH-VALUE FOFO FORO COF9 99 - C99 
MOVE LOW“VALUE | 4040 4040 — hO4O** 00 coo 
MOVE ALL "9" | F9FS FOF9 _COFI 99 C99 
MOVE ALL “0" _ FOFO FOFO | COFO 00 coo 
MOVE ALL aFFa FFFF FFFF CFFF FF CFF 
MOVE ALL 2002. FOFO FOFO COFO —- 00 C00 
“MOVE ZEROS F OFO F OF 0 COFO 00 C00 
MOVE SPACES 4040 LOLOea® HO4Oeee O08e® COOKes 
MOVE ALL ™ " 4040 4040 4040«* 00 C00 


* Known Error Crefer. to paragtann oe 3. 27) 
** Inconsistent 


zwexex Will pe syntaxed in a future release 
De4e4e When the Compiler Produces No Listing 


If the COBOL compiler comes to an abnormal end-of-job and no 


source listing is produced» there are certain steps that can be 
taken to find a temporary solution to the problea. 


The first step is to determine the statement or statements in the 
COBOL source which cause the problem. The "LISTP® dollar option 
causes the compiler to list the source images in the -initiatlt 
pasSe Errors detected in that pass are tisted as they occur. AS 
the source images are listed» a sequential number is printed = an 
the left side of the tisting. This number is used by the 
compiler to reference source images.. In some errors that are 
printed» this number » calted “TCARD" is also printed, This 
number can then be used to find the source statement that is in 
—errore In a DUMP/ANALYZER tListing of the compilers "TCARD* 
appears as the first 24-bit item in the “NAME STACK". Passes 
other than the initial pass list other errors as they occur. The 
errors found using “LISTP®™ should be corrected» then the program 
should be recompiled. The "$ TIME" option disptays the current 
phase of the compiler being executed and is most beneficial for 
debugging. 
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Whether or not a temporary solution is found» the problem Catong 
with all materials necessary to reproduce it) should be submitted 
together with a 81700 Field Trouble Report (form #1909603) by the 
tocal Burroughs support personnel. 


Se 4254, Compiler General Information and Optimization 


In order to achieve better utilization of memory on smatl memory 
Size systems» the COBOL compiler has been implemented in a 
multi-phase manner. In multi~phase compilation the original text 
is transformed to a more convenient form by passing it against a 
part of the compiler. The transformed text is then passed to the 
next phase via an intermediate work file. In this way the data 
is managed in a somewhat sequential manner» minimizing random 
overlaying. Code overtays are minimized in the same way because 
only apart of the code is invoked to transform all the data _ for 
the phase. 


Two disadvantages of multi-phase compilation are: 


ae If a large amount of memory is available at compile time» 
there is no way to combine phases. 


be. <A certain fixed: overhead is required _ for opening and 
closing of the intermediate sates? even for an extremely 
small source file. +3 

The COBOL compiler is divided into ten phases» as follows: 

ae "PARSE" - Initial Parsing. Merges source language inputs» 
creates or copies library files» creates report file» scans 
input and writes tokens to DNFILE and ALLONOUT for further 
processing. 


be "DICT" = Dictionary Processinge S8uilds a dictionary of atl 
declared datasnames and procedure-names. 


Ce “"DNQUAL” - Datatname Qualification Resolution. 
de. “LQUAL" = Label Cprocedure~name) Qualification Resolution. 


@.e. "MERGE" - Combine constant information about each data-name 
and procedure-name with a unique occurrence nuaber. 


f. “DATSYN™ = DATA DIVISION syntax checking. 


ges “EXPLODE"™ - Expand tokens in the PROCEDURE DIVISION to 
include atl known attributes for that token. 


he “"PROSYN™ - PROCEDURE DIVISION syntax checking. 


i- “CODEGEN" = Code generation. 
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je “FIXUP? = Produces a codefite (the executable object code) 
and a listing. 


When designing a compiler for many memory size configurations» it 
is important to effectively utilize additional memory if it is 
available. The COBOL compiter accomptishes this by managing the 
dynamic memory allocated at compile time. | | 


A certain minimum dynamic memory is required for building lists 
and tables during the different phases. Associated with this 


-minigua meaory are various Limits (for example, the number of 
data"names» procedure names» and so forth). If a particular 
source program exceeds any of these limits» more space must be 
dedicated by increasing the dynamic memory and recompiling. An 
attempt has been made to make these restrictions "reasonable". 
If additional dynamic memory is available» the compiler is 
designed to use that space for a significant speed gain. Some 


details regarding the use of dynamic memory may be found in the 
following paragraphs. 


The dynamic memory allocated to the COBOL compiler is used for 
many things. For the purposes of this discussions “text space” 
is defined as the space required to store a datastname» titeral» 
or procedure=name. For examples the text space for the data=name 
"MASTER“FILE™" is 11 bytes. Some of the uses of dynamic. memory 
and the amounts required are as foltows: 


ae COPY eeee REPLACING A BY B" pairs. Each data~name or 
literal requires its own text space» plus 9 bytes per pair. 


be Mnemonic names. Each name requires its own text space plus 
8 bytes. . 


ce Data names. Each data-name declared requires 38 bits. 


de Procedure names « Each procedure-name dectared requires 41 
bits. _ . . 
e. Condition names. Each "88" vatue list requires its own 


text space plus 7 bytes» optus an additional 5 bytes for 
each separate literal in the "VALUE" list. 


f. MONITOR. Each data name monitored requires 42 bits. Each 
procedure-name monitored requires its own text space plus 3 
bytese 


ge Library files. Creating or copying tibrary files requires 
486 bytes. 


he Dottlar options. “MERGE* and “NEW” each require 486 bytes. 
*"LISTP™ requires 326 bytes. 
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In order to minimize the intermediate file size» information 
about the original text is distributed to several files which are 
ordered to each other. The individual files are then processed 
without the need to copy extraneous information. When all of the 
transformations are completes the files are merged. 


The following list provides. some generat information about the 
files used and created by the compiler» such as internal namer 
external names device type» phases in which used» access types 
open type» which system drive directed to» and purpose: 


ae NEWSOURCE "COBOLW/SOURCE”" GPTIONAL DISK 

Created by PARSE. Contains source card images to which 
patch cards have been applied. Sequential access» GQUTPUT. 
Directed to system drive il» if possible. 


be LIBRARY — "COBOLW/LIBRARY™ OPTIONAL DISK . 
Used by PARSE to create or read tibrary files. Sequentiat 
access» INPUT and OUTPUT. Directed to system drive 1s if 
possible. . . - * 


ce. CARDS "CARDS" oe READER 
Used by PARSE. Contains source card images or patch cards. 
Sequential access» INPUT. 4 


d- SOURCE — "COBOLW/SOURCE” OPTIONAL DISK 
Used by PARSE. Contains source card images to which 
patches may be apptied. Sequential access» INPUT. 


ee REPORT “COBOLW/REPORT* DISK 
Used by PARSE COUTPUT) and FIXUP CINPUT). Contains att 
card images processed» including dollar cards»e tibrary 
cards» and patch cards. Used to print the listing. 
Sequential accesse Directed to system drive 1» if 


possible. 


f. ONFILEX "COBOLW/DNFILE® | DISK 
Used by DICT» DNQUAL» and LQUAL. Contains alt picture 
strings and variables reduced to an occurrence number. 
Also used by MERGE and DATSYN to contain an entry for each 
unique picture string of the DATA DIVISION. Sequential 
access. Directed to system drive 0. 


Ge SEGFILE "COBOLW/SEGFILE* . DISK 
Used by MERGE» DATSYN» CODEGEN> and FIXUP. Contains edit 
masks» values to which the WORKING-STORAGE variables should 
be initialized» error or warning messages and various other 
information which is used to build the codefilte and supply 
additional data for the i oe Random accesse Directed 
to system drive 0. 


he LINE "LINE" PRINTER 
Used by FIXUP for Listings or by any phase for compiter 
debugging output. 
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ie ADNFILE "“COBOLW/ADAFILE* DISK 
Used by MERGE» DATSYN» EXPLODE» and PROSYN. Contains 
merged tokens of ALLONOUT and ADFILE. Sequential access. 
Directed to system drive 1» if possible. 


j- ADFILE "COBOLW/ADF ILE” DISK 

Used by PARSE» DICT» DNQUAL» LQUAL» and MERGE to contain 
picture strings and alt variable names isotated (for 
example» section*names» paragraph names» and data names). 
Also used by CODEGEN and FIXUP to contain explicit 
Cprocedure~names) and implicit (compiler-generated branch 
points) label attributes used for generating the correct 
branch addresses. Also used by EXPLODE and PROSYN to 
contain tokens which have been expanded to inctude att the 
known attributes for that tokens Random access. Directed 
to system drive le if possible (note: this is a change 
from the Mark VI.1 release Letter documentation). 


ke ALLONOUT "COBOLW/ALLDNOUT™ | DISK 
Used by PARSE and MERGE to contain alt constant information 
about each token processed. Also used by DATSYN and 


EXPLODE to contain an entry for each explicit data name 
Cexcluding FILLER entries). Each entry contains attributes 
such as usage» address» Length» number of subscripts 
required» and so forth. Also used by PROSYN and CODEGEN to 
contain tokens that have been syntax checked» rearrangeds 
and simplified -for code generation. Random access. 
Directed to system drive 1» if possible. 


lL. CODEFILE = “COBOLW/CODEFILE™ DISK 
: Created by FIXUP. Contains the object program according to 
MCP specifications. Not created if syntax errors are 


detected. Random access. Directed to system drive 0. 


If the system being used for compilation does not have multiple 
system drives» those files which are directed to system drive 1 
can be modified to reside on a user packs if one is available» to 
achieve better disk utilization. 


As a general rule, the most effective way to optimize COBOL 
compiles is to utilize dynamic memory to minimize disk accesses. 
For several phases where sufficient dynamic memory to maintain 
information in memory rather than on disk is allocated» files are 
loaded into tables and accessed» rather than randomly accessed on 
disk. AS aresult» compile times can be significantty reduced. 


In order to determine whether the labels are being processed in 
memory or on disk» the doltar option card “TIME” can be used. 
This option causes compile statistics to be printed following the 
nocgaal compilation output. The fields called EXPLICIT-LABELS and 
EXPLICIT.DATA.NAMES can be multiplied by the amount of memory 
required for each to determine the minimum amount of dynamic 
memorye 
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924282 New and Changed Compiter Error Messages 


C151) INVALID DESCRIPTION FOR ACTUAL KEY 


(366) MERGE COMPILER ERROR» BAD PC.~OCCUR» SUBMIT SOURCE AND TROUBLE 
REPORT 


Se4els Introduction to the Indexed I70 Module 
Function 


The Indexed [+0 Module provides the capability to access records 
of a#$=mass storage file in either a RANDOM or SEQUENTIAL manner. 
Each record in an Indexed file is uniquely identified by the 
value of a key within that record. 


Level Characteristics © 

The 8B 1800/8 1700 COBOL compiler utilizes the ANSI“74 syntax for 
the Indexed I-0 Module» with the exception of the "DELETE" verb 
and the ALTERNATE KEYS options which are not implemented» and the 
Burroughs extensions to the "AT END™ and “INVALID KEY" clauses. 


Language Concepts 
Organization 


A file whose "QRGANIZATION IS INDEXED" is a mass storage file in 
which data records are accessed by the value of a key. A record 
description includes a key data item which is associated with an 
index. The index provides a logical path to the data records 
according to the contents of a data item within each record» 
which is the record key for that index. 


The data item named in the RECORD KEY clause of the FILE-CONTROL 
entry for a file is the “prime” record key for that file. For 
purposes of inserting and updating records in a file» each record 
is identified solely by the value of its prime record key. This 
value must» therefore» be unique and must not be changed when 
updating the record. 


Access Modes 


In the "SEQUENTIAL™ access mode» the sequence in which records 
are accessed is the ascending order of the record key vatuese 


In the *RANDOM™ access mode» the sequence in which records are 
accessed is controttled by the prograamer. The desired record is 
accessed by ptacing the value of its record key in a record key 
data item. ; 


In the "DYNAMIC™ access mode» the programmer may change at wilt 
from SEQUENTIAL to RANDOM access using appropriate forms of 
input-output statements. 
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Curcent Record Pointer 


The current record pointer is a conceptual entity used in this 
document to facilitate specification of the next record to be 
accessed within a given file. The concept of the current record 
pointer has no meaning for a file opened in the OUTPUT mode. The 
setting of the current record pointer is affected only by the 
"OPEN"» "START™» and "READ™ statements. | 


I-0 Status 


If the "FILE STATUS@ clause is specified in a FILE-CONTROL entry» 
a value is placed into the specified two-character data _ item 
during the execution of an *OPEN%» “CLOSE%» “READ"» “WRITE®» 
"REWRITE"%>» or “START"™ statement and before any applicable “"USE* 
procedure is executed>s to indicate to the COBOL program the 
status of that input~output operation. 


Status Key 1. 


The Leftmost character position of the FILE STATUS data item is 
known aS Status Key 1 and is set to indicate one of the following 
conditions upon completion of the inputsoutput operation: 


Successful Completion 
AT END . 
INVALID KEY 

Permanent Error 
Implementor Defined 


OWN = 


The meanings of the above indications are as follows: 


0 Successful Completion. The input-output statement was 
successfully executed. . 


1 AT END. The Format 1 “READ™ statement was unsuccessfully 
executed as a result of an attempt to read a record when no 
next logical record exists in the file. 


2 INVALID KEY. The input-output statement was unsuccessfully 
executed as a result.of one of the following: 


Sequence Error 
Duplicate Key 
No Record Found 


3 Permanent Error. The input-output statement was 
unsuccessful as the result of an inputcroutput errors» such 
as Data Check, Parity Errors or a Transmission Error. 
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9 Implementor Defined. The inputroutput statement was 


unsuccessfully executed as a result of a condition that is 
specified by the implementor. This value is used only to 


indicate a condition not indicated by other defined values 
of Status Key Il» or by specified combinations of Status Key 
1 and Status Key 2. j 


Status Key 2 


The rightmost character position of the FILE STATUS data item is 
known as Status Key 2 and is used to further describe the results 
of the input-output operation. This character contains a value 
as follows: ; 


as If no further information is’ available concerning the 


input-output operation» then Status Key 2 contains a value 
of 0". 


be When Status Key 1 contains a value of "2" Cindicating an 
"INVALID KEY" condition)» Status Key 2 is used to designate 
the cause of that conditions as foltows: 


1.- A value of "1" in Status Key 2 indicates a sequence 
error for a sequentially~accessed Indexed file» meaning 
that the ascending sequence requirements of successive 
record key values have been violated (refer to the 
"WRITE" statement)» or the prime record key value’ has 

been. changed by the COBOL program between the 

successful execution of a "READ™ statement and the 
execution of the next "REWRITE" statement for that 
file. 


Ze A value of "2" in Status Key 2 indicates a duplicate 
key value» meaning that an attempt has been made to 


WRITE" of "REWRITE" a record that would create a 
duplicate key in an indexed file. 


3. A value of "3" in Status Key 2 indicates no record 
found» meaning that an attempt has been made to access 
a record identified by a key» and that record does not 
exist in the file. 


ce When Status Key 1 contains a value of “9" (Cindicating an 
implementor-defined condition)» a value of "3" in Status 
Key 2 indicates that the record key value contained in the 
data file record is not equal to the record key yalue 
contained in the associated tag file record. 


Valid Combinations of Status Keys 1 and 2 


Allowable combinations for the value of Status Key 1 and Status 
Key 2 are shown in the following table. An ™X" at an 
intersection indicates a valid combination. 
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The TINVALIO KEY" Condition 


An “INVALID KEY" condition can occur as a result of the execution 
of a “START™» “READ™» “WRITE"» or “REWRITE” statement. For 
details on the causes of this conditions refer to the appropriate 
statement. 


When the “INVALID KEY" condition is ‘recognized, actions are taken 
in the following order: 


ae A vatue is placed into the FILE STATUS data item» if 
specified for the file» to indicate an "INVALID KEY” 
condition Crefer to [-0 Status). 


be If the “INVALID KEY" phrase is specified in the statement 
causing the condition» control. is transferred to the 
"INVALID KEY" statement. Any “USE™" procedure specified for 
the file is not executed. oe 


ce If the “INVALID KEY™ phrase is not specified but a "USE" 
procedure is specified» either explicitly or implicitly» 
for the file» that procedure is executed. 


When the “INVALID KEY" condition occurs» execution of the 
input~output statement which recognized the condition is 
unsuccessful and the file is not affected. 


Ihe "AI END" Condition 


An wAT END" condition can. occur as a result of execution of a 
"READ" statement. For details of the causes of this condition, 
refer to the "READ" statement. 
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General Imolementation Information 
Physical Files 
As implemented» Indexed files consist of two physical files: 


(ae The data file contains records written to the tite by the 
program and is maintained in the order in which the records 
are first written. | 


be The “tag” file contains the record key vatue and the 
relative record number of its associated record in the data 
file. This file is ordered on record key value» and is 
read» written» and maintained transparent to the COBOL user 
by compiler-generated subroutines. These subroutines» or 
"Indexed Control System” CICS)» also provide for opening 
and closing of the tag file. 


Iag Files 


A tag file record contains a record key and a pointer to the 
relative Location in the data file of the data record whose 
record key is the same value as that in the tag file record. The 
record key is an exact copy of the record key field in the data 


file record. Dupticate keys are not allowed. The tag file is 
blocked so that as many records as possible are ptaced into a 
180-character block. . If the record key is greater than 176 


characters in lengths» the tag file is unblocked. 


The internat and external names of the tag file are generated by 
the ICS by prefixing the word "TAG" to the internal and external 
nawges of the data file» as shown in the following examples: 


i Internal File Names i External File Names ' 
J wma manana aw aman aaane amas Sfaevwana ws eee manawa ane enaeaeacananwoe | 
t Data File 1 Tag Fite { Data File ! Tag File ] 
1 FILE ! TAGFILEL § ASB. ! TAGA/B ! 
[sSse=72=e" x ard ea  ag  l  a| 
( FILE2 i TAGFILE2 i FILE2 | 1 TAGFILE2 t 
! FILE3 | TAGFILES t CCC/A/B (| CCC/TAGA/B ! 


“4 FILE4 1 TAGFILE4 t A/ABCDEFGHI t TAGA/ABCDEFGHI 1 


t FILES i TAGFILES t A/B/ — - A/TAGBS/ ! 
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RPG ang COBOL File Compatibility 


In order to accommodate those users wishing to process Indexed 
files by both RPG and COSOL programs» the "RPGTAG" dotlar option 
is available. in the COBOL compiler. This options when sete 
causes the compiler to generate code to process Indexed files 
using tag files with the same format and external names as if 
those tag files had been created by an. RPG program. These files 
cannote however» be used if the program is executed under File 
Security Cunless run with a privileged usercode/password). 


The difference in tag file format is due to the use by COBOL of 
an eighte-digit pointer in the tag file records» white RPG uses a 
sixdigit pointer. The targer pointer enables COBOL users to 
process larger files than RPG Limitations allow. 


The difference in the external names of the tag files is due to 
the prefixing by COBOL of the word *TAG™ to the family-name of 
the data file to produce the tag file name» where RPG prefixes 


"TAG" to the sub-directory name. Prefixing the family=name 
rather than the sub-directory name enables COBUL to generate» in 
some CaseS» a single-file name for the tag file. This allows 
Indexed files to be processed under the File Security system if 
desired. If "RPGTAGS* had been specified in the COBOL prograa 
which created the tag files in the preceding examples the 
external tag file names would have been ereated as follows: 

A/TAGB 

FILE2/TAG 

CCC/A/TAGB 

A/TAGABCDEFG. 

A/B/TAG 


Another point to consider if it is necessary to access the same 


Indexed files with both COBQL and RPG programs is that COBOL only 
permits alphanumeric keys. 


Rough Tables 


In order to minimize disk accesses when searching the tag file 
for record keys» the ICS» as a function of opening the tag file> 
creates a "rough table* in memory which logically breaks the tag 
file into partitions. This table consists of. as many entries as 
will fit into the space provided (refer to the "VALUE OF" clause) 
ors by defaults» ten (10) entries. Each entry consists of the 
record key which occupies the tast record in the partition. The 
number of records contained in a partition is determined by the 
number of records in the fite divided by the number of table 
entries allowed. . . 


A rough table is built for alt opens of files with "ORGANIZATION 
INDEXED™» except for those opened OUTPUT with SEQUENTIAL access, 
and those which are opened INPUT with SEQUENTIAL access for which 
there is no “START™ statement contained in the program. As the 
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rough table is built» the entries are sequence-checked to insure 
that the binary search algorithm can function correctly. If the 
entries are not in sequence,» the program is immediately 
terminated. 


searching the Jag File 


A binary search method is used to tocate the desired key between 
successive entries in the rough table. The partition boundaries 
are then calculated by multiplying these entry numbers by the 
number of tag records contained in the partitions. — ‘A binary 
search of the tag file between those boundaries is then done to 
find the required record. When the tag record is founds the 
relative record number is used to make the associated record from 
the data file available to the COBOL program. If the key is not 
found in the above manner and records have been added to the fite 
since the last reordering of the tag file» the records which have 
been added to the tag file are serially searched for the required 
keye 


In an effort to minimize the number of disk reads required to 
locate a particular record» the fotlowing optimizations have been 
used: . 


ae The required key is checked for equal to the key found ‘in 
the rough table. If they are equals the tag file record is 
read without requiring the binary search of that partition. 


be. If the partition found in the rough table contains’ the 
end-of-file records the required key is compared to the key 
of the end-of-file record. If the requested key is 
greater, the added records Cif any) are searched» and the 
binary search of that partition is avoided. 


be. When records are added» the highest and lowest keys added 
are savede The required key is range~checked with those 
values. If the required key is outside that ranges the 
serial search of the added records is unnecessary. 


Adding Records to the Files 


When the tag and data files are opened» their end-of-file 
pointers (which must be equat) are obtained. This end-of~file 
pointer CEOFTPOINTER) is placed in NEW*EOF-POINTER. New records 
are appended to the end of each file by adding one to 
NEWWEOF*“POINTER and using the resulting value as the actual key 
of both the tag and data files. . 


When the file is closed» or when a “START"» or “READ s28 NEXT™ 
statement is executed and records have been added to the file> 
the tag file is sorted (does not apply to SEQUENTIAL access). 
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ENVIRONMENT DIVISION In The Indexed I-90 module 

The FILE-CONTROL Paragraph 

Function 

The FILE"CONTROL entry names a file and may specify other 
fite-related information. This description of the FILE“CONTROL 
entry only describes those clauses which are timited to _ the 
Indexed I-00 Module. . 

General Eormat 


SELECT file~name 


¢ DISK ) 

¢ anam ) 

ASSIGN TO ¢ ) 
cence DISKPACK. ) 
sn ame ae ) 


ORGANIZATION 15 INDEXED 


{ ~CSEQUENTIAL) 1 
{[ ACCESS MODE IS CRANDOM | 
{ CDYNAMIC ») Jj 


RECORD KEY IS datasname-t1 


{ FILE STATUS IS data~name 2] 


syntax Rules 


ae The "SELECT" clause must be specified first in the 
FILE*CONTROL entry. The clauses which follow the "SELECT® 
clause may appear in any order. 


be Each file described in the DATA DIVISION must be named once 
and only once as filename in the FILE-CONTROL paragraph. 
Each file. specified in the FILE*CONTROL entry must have a 
File Description entry in the DATA DOIVISION. 


ge 
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If the "ACCESS" clause is not specified» "ACCESS MODE IS 
SEQUENTIAL™ is implied. | 


Datasname-2 must be defined in the DATA DIVISION as a 
twoecharacter data item of the category alphanumeric and 
must not be defined in the FILE SECTION. 


Datasname-1 and data™name-2 may be qualified. 
The data item referenced by data-name~1 must be defined as 
a data item of the category alphanumeric within a Record 


Description entry associated with that file-name. 


Datasname-1l cannot describe an item whose size is variable 
(refer to the "OCCURS" clause). . 


General Rules 


Ge 


be 


he 


The *"ASSIGN® clause specifies the association of the file 


referenced by file-name to a mass storage medium. 


The “ORGANIZATION” clause specifies the logical structure 
of a file. The file organization is established at the 
time a file is created and cannot subsequently be changed. 


When *ACCESS MODE IS SEQUENTIAL"» records in the file are 
accessed in the sequence dictated by the file organization. 
For Indexed files» this sequence is the order of ascending 
record key values within a given key of reference. 


If "ACCESS MODE IS RANDOM",s the value of the record key 
data item indicates the record to be accessed. 


When “ACCESS MODE IS DYNAMIC™,» records in the file may be 
accessed sequentially and/or randoaly (Crefer to General 
Rules c and d). a 


When the "FILE STATUS" clause is specified» a value is 


moved by the ICS into the data item specitied by 


data-name-2 after the execution of any statement that 
references that file either explicitly or implicitly. This 
value indicates the status of execution of the statement. 


The "RECORD KEY" clause specifies the record key for the 


file. The values of the record key must be unique =  amang 
records of. the fite. The record key provides an access 
path to records in an Indexed file. 


The Data Description of data*name-1> as wett as its 
relative location within a records must be the same as that 
used when the file was created. 
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DATA QIVISION in the Indexed I-Q Module 

Ihe File Description = Entry akeleton 

Function 

The File Description furnishes’ information concerning the 
physical structures identification» and record names pertaining. 
to a given file. This discussion of the File Description entry 
CFO)» provides details only of those clauses which have special 
meaning in the Indexed I°0 Module. 


General Format 


i 

( FD fite~name 1 
( “= ! 
| : ! 
| { (VALUE) CIDENTIFICATION) (data*name1 )J i 
Po Utter") OF Cntesrernresen-) 15 ¢ ae 
{ CCVA ) @ €)) ) (literale-l ) | 
i C¢=s ) (= ) J | 
i | 7 | i 
I { VALUE OF CORE-INDEX IS integer-1 CHARACTERS ] 1 
’ {...s"s> Sass ses 2 ='s . ] i 
| t 


ayntax Rules 


ae The level indicator FD identifies the beginning of a File 
Description and must precede the file-name. 


be The clauses which follow the name of the file are optional 
in many cases» and their order of appearance is immaterial. 


ce Qne or more Record Description entries must follow the File 
Description entry. 


Ihe “VALUE QE" Clause 
Function 
The "VALUE OF" clause provides for the identification of a 


file and its retated tag file, 


of the amount of memory to be allocated to the rough table. 


General Eormat 


eM SOO ae DS HSS Sean Bae €£ OSE SF Oe BW OG eww e Fee aan @enaaneaaenae ae 


(VALUE) CIDENTIFICATION). (data-name~1) 
CVA ) ~ CIO Ds. (titeral-l ) 


C VALUE OF CORE@INDEX IS integer=1 CHARACTERS } 


{ a ee) asneae nunmananw eae ] 


i i 
I 
i 
i 
! (5) (-- yo. -, i 
i 
" ' 
i i 
i 


EEO we ee SS sane SS HP GH qa G* aS FE OBO aS Gee as as enna Qaae 


Syotax Rules 
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data 


as well as allowing specification 


Datasname-1 should be qualified when necessary» but cannot be 
subscripted or indexed» nor can it be an item described 
the "USAGE IS INDEX® clause. ; . 


General Rules 


ae 


For the IDENTIFICATION option: 


1. For an input file» the MCP checks to see if a data 
-whose name is equal to the value of titerat-1 
data~name"1+»+ whichever has been specified» as wel 
its associated tag file are present in the 
directory. 7 


2- For an output file» at the appropriate time a data 
whose name is made equal to the value of literal-1 
data-sname~1l» whichever has been specified» as wel 
its associated tag file are inserted into the 
directory (refer to Tag Files). 


with 


file 
or 
Ll as 


disk 


file 
or 
t as 


disk 


For the “*CORETINDEX"™ . options the number of characters 


specified by integer-1 is allocated for storage of 


the 


rough table. If this option is omitteds the number of 


characters required to contain ten (10) entries 
atlocated (Crefer to Rough Tables). 


is 


PROCEDURE DIVISION in the Indexed I-0 Module 


The CLOSE Statement 


Function 


The "CLOSE" statement terminates 


specifies the disposition of the f 


General Format 


ile. 
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the processing of a file and 


! 
' C 
' { 
1 CLOSE file-name~1 CWITH 
I epee ee “st 
t C 
d { 
t C 
t { 
i 
1 a { 
{ { C 
| { file snamer2 CWITH 
i C C 
! {. .% 
! C t 
i C C 
t C { 
i 


 Syptax Rules 


CLOCK 


(wae -. 


CRELEASE 


(ween wee 


CRE MOVE 


C PURGE 


¢ ana e w 


(LOCK 


(ec 


CREMOVE 


(w@oewmae 


CPURGE | 


a et ed 


at et et tw 


wt wee et et ee ee ll 


fened famed eect heed heed heed ed heed 


re oe ee ee ee | 


ee ee ee 
ee ee ee ee ee ee ee ee 


The files referenced in the "CLOSE* statement need not atl have 


the same QRGANIZATION or ACCESS. 


General Rules 


ae A "CLOSE" statement may onty be executed for a file in the 


OPEN mode. 


b. Indexed files are labeled mass storage files. 


The results 


of executing each type of “CLOSE” are summarized jn the 


following table: 
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4 CLOSE i File i 
I Statement Format t Disposition 1! 
Peres iseessaen teense sess se esesessses=a | 
| CLOSE i is 3 | 
{ weet wee rm wmae ween want eames ae wwe | 
{ CLOSE WITH LOCK ! dls 2e 4 i 
{ CLOSE WITH RELEASE 8 Io 25 & i 
Jfrrectee “Hse aDomanat_amranaaanaaaw a | 
# CLOSE WITH REMOVE ¢t 1» 4e 5 ! 
pers rr ewww enw semen owas woaecanoaes | 
1 CLOSE WITH PURGE ] l> 6 ‘ 


The definitions of the symbols in the table are as fottlows: 


1. File CLOSE. The "CLOSE" operation marks the logical 
file as closed. . | 


2. File Lock. The physical file is made a permanent 
file and is entered into the MCP disk directory. 


3. File Retention. The association between the logical 
file and the physical file is retained. A new file 
is not entered in the disk directory» and is lost at 
end-of-job Cor overwritten following a subsequent 
"OPEN OUTPUT"), if not closed with “"LOCK"» "RELEASE™> 
or *REMOVE*™. : 


4. File Release. The association between the logical 
file and the physical file is severed. The areas of 
memory allocated for buffers are released to the 
system. oo 

5S. File Remove. This option causes the MCP to remove 
from the disk directory. a file which has the same 
external name as the file being closed. This action 


takes place prior to entering the external name in 
the disk directory. - 


6- File Purge. If the file is a permanent’ file>» the 
file is removed from the disk directory» and the 
storage area occupied by the file is reteased as 
available to the MCP. 


If ae fite is in the OPEN mode when a “STOP RUN” statement 


is executed or when an abnormal terminaticn. occurs» the 


action taken is to close the file as though a simple 
"CLOSE" statement had been executed. 
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de If a “CLOSE” statement has been executed for a_e file» no 
other statement can be executed that references that file, 
either explicitly or implicitly» unless an intervening 
"OPEN® statement for that file is executed. 


The execution of a "CLOSE" statement has no effect upon the 
contents or the availability of the file's record area. 
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Ihe OPEN Statement 
Function 
| The "OPEN" statement initiates the processing of files. It abso 


performs checking and/or writing of labels and other input~output 
operations. . 


General Format 


TDD SE EM BOM SHORES AB ERE OOD MN HEB HSS BASRA SSASO*A STH SV EA OSSTNHHOESOSe BF fee G2 Oe & 


CINPUT file~namerl CWITH LOCK CACCESS]) 


Nest rk 


¢ eam we or ee 


i ] 
i ) I 
1 ) ] 
{ ( » J 
{ ¢ { file-name"2 CWITH LOCK LACCESS]) } eee ) 1 
] C . ee. eae ees > 4 
{ ¢ ) ] 
] OPEN COUTPUT file~name-3 € file~name"4] ... » J 
i ose (sameness » | 
{ ¢ » 1 
{ CI*0 file-names5 CWITH LOCK CACCESSI] » | 
{ (=e a en . ) i] 
] C » 1 
t ( {C file- nawexe CWITH LOCK CACCESS]) J ee ) J 
t ) ! 
{ ] 


Syntax Rules 


The files referenced in the "OPEN" statement need not all have 
the same ORGANIZATION or ACCESS. 


General Rules 


ae The successful execution of an “OPEN* statement determines 


the availability of the file and results in the file being 
in an OPEN mode. 


be The execution of an "OPEN" statement does not affect either 
the contents or availability of the filets record area. 


ce When a given file is not in an OGPEN- mode» no statement 
Cexcept for a "SORT" or “"MERGE™ statement with the "USING" 
or “GIVING" phrases) can be executed that references the 
files either explicitly or implicitly. 


de 


fhe 
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A file may he opened with the "INPUT". “QUTPUT"» and "I-70" 
phrases in the sage program. Following the initial 
execution of an “*OPEN" statement for aie file» each 
subsequent “OPEN® Statement executed for the same file must 
be preceded by the execution of a "CLOSE" statement for the 
file. | 


An “OPEN™ statement must be successfully executed prior to 
the execution of any of the permissible input-output 
statements. In the following table» an “"X" indicates that 
the specified statement» used in the file access mode given 
for that rows may be used with the OPEN nose given at the 


top of the cotumn. 


1 mee ie ee a OPEN Mode | ! 
1 File Access |. lla a ln a ll chao 
i Mode  ' Statement | INPUT § QUTPUT | INPUT-OUTPUT 1 
fSSsosScee stat eae sete Se se se Sse seae ss Ste sce ss Ss SSse SSeS SsScecec { 
4 1 READ i X i 4 x ! 
| SEQUENTIAL J§ WRITE © t 4 X i i 
1 1 REWRITE i i 1 x ! 
i 1 START ' x ae i X l 
 Kclechelatatntetetelatatetad teketetetalntetatelatel teketetetateted teletalatelalated tatetekahatetetetatetatatatel | 
! 1 READ ' X ‘ 1 x i 
! RANDOM 1 WRITE ! i X i x 4 
i t REWRITE 4 4 i x i 
‘ 1 START i 1 | t 1 
J ewer eme nw een aefpasnenasaaneat ten nenatpaneaanan pes enaewsesea= a | 
{ a 1 READ t 4 i | i x \ 
1 DYNAMIC U WRITE 1 t xX 1 x t 
i t REWRITE i i ae a. | 
1 ! START 1 x t l x i 


Execution of. the "OPEN" statement does not obtain or 
release the first data record. 


The File Description entry for file-name-1>» file-name~2»: 
file-name"S» or filetname-6 must be equivalent to that used 
when the. file was created. 


For files being opened with the INPUT? or "I-00" phrase» 
the “OPEN™ statement sets the current record pointer to the 
first record currently existing within the file, For 
Indexed files» the “prime” record key is established as the 
key of reference and is used to determine the first record 
to be accessed. If no records exist in the filer the 
current record pointer is set such that the next executed 
Format 1 "READ" statement for the file results in an “AT 
END® condition. 
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The *"f1-0" phrase permits the opening of a file for both 
INPUT and OUTPUT operations. Since this phrase implies the 
existence of the file» it cannot be usec if the file is 
being initially created. . 


Upon successful execution of an "OPEN" statement with the 
“QUTPUT™ phrase specified» a file tis created.~ At that time 
the associated file contains no data records. 


When an "OPEN WITH LOCK" Cwithout "ACCESS") is executed» 
the following occurs: 


1. If the specified file is already in an OPEN mode by 

- another program or by a different filename within this 

programe the program is suspended awaiting exclusive 
availability of the file. 


2e If the file is not currently in an OPEN mode by any 
i programe the file is opened. . 


When an “OPEN WITH LOCK ACCESS" is executed» the program is 
suspended if any of the following conditions exist: 


le The file is currently OPEN WITH LOCK. 
2. The file is currently OPEN INPUT-OUTPUT. 


3. This OPEN is I70 and the file is currently OPEN INPUT 
LOCK ACCESS. 


The program remains suspended until none of these 
conditions remain» or until the program is terminated. In 
any other case» the "OPEN WITH LOCK ACCESS" causes the file 
to be opened. 
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The READ Stategent 
Function 


For SEQUENTIAL access» the "READ" statement makes available the 


next Logical record from a file. For RANDQM access» the "READ" 


statement makes available a specified record from a mass storage 
file. 


General Eormat 


Format 1: 


READ file=name CNEXT] RECORD CINTO identifier] 


C AT ENO statementrl CELSE statement-2)] 


MEME B MEE BEB SHE BSABA RSS BF SESLASA*A SSO BSB BSA RSSHS*BDSAAA SSOS*AASEABDABSE ST OBaeae 


Format 2: 


READ file-name RECORD CINTC identifier] 


t 
{ ! 
' i. 
t a , i 
I “C€ KEY IS dataename] ! 
i aoe ] 
] ! 
! { INVALID KEY statement~-l (ELSE statement-21] 1 
( 1 
f | 


ayotax Rules 
ae The storage area associated with identifier and the storage 
. area which is the record area associated with file-name 
must not be the same. 


be Data~name must be the name of a data item specified as a 
record key associated with file-name. : | 


ce OData-name may be qualified. 


de Format 1 must be used for all files in SEQUENTIAL access 
mode. . 
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The “NEXT” phrase must be specified for files in DYNAMIC 
access mode» when records are to be retrieved sequentially. 


Format 2 is used for files in RANDOM access mode or for 
files in DYNAMIC access mode when records are to be 
retrieved randoaly. . 


The “INVALID KEY" phrase or the "aT ENO" phrase must be 
specified if no applicabte "USE" procedure is specified for 
filename. 


General Rules 


ae 


The associated file must be OPEN in the INPUT or I°0 mode 


at the time this statement is executed (refer to the OPEN 
Statement)... . 


The record to be made available by a Format 1 "READ" 
statement is determined as fottows: 


1. The record pointed to by the current record pointer is 
made available» provided that the current record 
pointer was positioned by a "START" or "OPEN" 
Statement. 


Ze If the current record pointer was positioned by the. 
execution of a previous "READ" statement» the current 
record pointer is updated to point to the next existing 

record in the file and then that record is = made 
available. . | 


The execution of the "READ® statement causes the value of 


the File Status data item» if any» assoctated with 
file-name to be updated Crefer to I7*0 Status). 


Regardless of the method used to. overtap access time with 
processing times the concept of the "READ™ statement ts 
unchanged in that a erecord is _  availante to the object 
program prior to the execution of any statement following 
the “READ™ statement. 


When the togicat records of a fite are described with more 
than one Record Descriptions these records automatically 
share the same storage area; this is equivalent to an 
iaplicit redefinition of the area. 


If the "INTO" phrase is specified» the record being read is 
moved from the record area to the area specified by 
identifier according to the rules specified for the "MOVE" 
statement (Cwithout the “CORRESPONDING* phrase) with the 
sending area considered to be a group item whose size is 
equal to the maximum record size for the file~- The implied 
move does not occur if the execution of the "READ*® 


is 
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statement was unsuccessful. Any subscripting or indexing 
associated with identifier is evaluated after the record 


has been read and immediately before it is moved to the 


data item. 


When the "INTO" phrase is used» the record being read is 
available in both the input record area and the data area 
associated with identifier. 


If» at the time of execution of a Format 1 =“READ"* 
statement» the position of the current record pointer for 
the file is undefined» the execution of that “READ” 
statement is unsuccessful. 


If» at the time of the execution of a Format 1 "READ" 


Statements no next logical record exists in the file» the 
“VAT END™ condition occurs» and the execution of the "READ" 


statement is unsuccessful (refer to [°0 Status). 


When the "AT END®™ condition is recognized the following 


actions are taken in the specified order: 


1. A value is placed into the File Status data item» if 
specified for this filer to indicate an "AT. END" 
condition Crefer to I°-0 Status). 


2. If the "AT END" phrase is specified in the statement 
causing the condition,» control is transferred. to the 
"AT END" statement-1. Any “USE” procedure specified 
for the file is not executed. | 


3e If the "AT END® phrase ts not specified» then a- *USE*®™ 
procedure must be specified» either explicitly or 


implicitly» for the file» and that procedure is 
executed. 
When the "AT END". condition occurs» execution of the 
inputeoutput statement which caused the condition is 


unsuccessful. 


Following the unsuccessful execution of any "READ® 
statement» the contents of the associated record area and 
the position of the current record pointer are undefined. 
For Indexed fites» the key of reference is also undefined. 


When the “AT END“ condition has been recognized» a Farmat 1 
"READ" statement for the file must not be executed without 
first executing one of the following: 


1. A successful "CLOSE* statement followed by the 
execution of a successful “OPEN” statement for the 
file. 


26 A successful “START” statement for the file. 


De 
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3. A successful Format 2 "READ™ statement for the file. 


For a file for which DYNAMIC access mode is specified» a 
Format 2 “READ® statement with the "NEXT" phrase specified 
causes the next togical record to be retrieved from that file 
as described in General Rule b. 


For an Indexed file, if the "KEY" phrase is specified in a 
Format 2 *"READ®™ statement» data*name is established as the 
key of reference for this retrieval. If the DYNAMIC access 
mode is specified» this key of reference is also used _ for 
retrievals by any subsequent executions of Format 1 "READ" 
statements for the file until a different key of reference is 
established. 


If the "KEY" phrase is not specified in a Format 2 *“READ"™ 
statements the "prime”™ record key is established as the key 
of reference for this retrieval. If the DYNAMIC access mode 
is specified» this key of reference is also used _ for 
retrievals by any subsequent executions of Format 1 "READ" 
statements for the file until a different key of reference is 
established. , 


Execution of a Format 2 "READ® statement causes the value of 
the key of reference to be compared with the vatue contained 
in the corresponding data item of the stored records in the 


file» until a record having an equal value is found. The 
current pointer is positioned to this record» which is then 
made available. If no record can be so _ identified» the 


"INVALID KEY" condition exists and execution of the "READ® 
Statement is unsuccessful (Crefer to the “INVALID KEY" 
Condition). . 
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The REWRITE Statement 
Function 


The "REWRITE" statement logically replaces a record existing in a 
mass storage file. . 


General Format 


Ck ee ee ee eee eee ee ee ee ee ee eee eee eee ee eee es 


REWRITE record-name (FROM identifier] 


nea nmin ae ab oe 


{ 
] 
| 
{ . Sie 

! C INVALID KEY statement-1 CELSE statement-2]] 
I . | 

§ 


ayntax Rules 


ae 


b. 


Record=name and identifier must not refer to the same storage 


areas 


‘Record=name_ is the name of a tlogical record in the FILE 


SECTION of the DATA DIVISTON and may be qualified. 


The "INVALID KEY" phrase must be specified in the “"REWRITE® 


statement for files for which an appropriate "USE" procedure 


is not specified. 


General Rules 


ae 


The file associated with record-name must be OPEN in the I-0 
mode at the time of execution of this statement (refer to the 


OPEN Statement). 


For files in the SEQUENTIAL access moder . the last 
input*output statement executed for the associated fite prior 
to the execution of the “REWRITE” statement must have been a 
successfully~executed “READ” statement. The record that was 
accessed by the “READ” statement is logicaliy replaced. 


The number of character positions in the record referenced by 
record-name must be equal to the number of character 
positions in the record being replaced. 


The togical record reteased by successful execution of the 
"REWRITE" statement is no longer available in the record area 
unless the associated file is named in a “SAME RECORD AREA” 
phrases in which case the togical record is available to the 
program as a record of other files. ; 


f. 


he 


v7 


The execution of a “REWRITE” statement with the "FROM™ phrase 
is equivalent to the execution of: 


MOVE identifier TO record-“name 


followed by the execution of the same “REWRITE” statement 
without the "FROM" phrase. The contents of the record area 
prior to the execution of the implicit MOVE statement have no 
effect on the execution of the “REWRITE” statement. 


The current record pointer is not affected by the execution 
of a "REWRITE" statement. 


The execution of the "REWRITE" statement causes the value of 
the File Status data item» if any» associated with the file 
to be updated (refer to [°C Status). 


For a file in the SEQUENTIAL mode» the record to be replaced 
is specified by the value contained tn the prime record key. 
When the “REWRITE” statement is executed» the value contained 
in the prime record key data item of the record to be 
replaced must be equal to the value of the prime record key 
of the Last record read from this file. : 


For a file in the RANDOM or DYNAMIC access mode» the record 
to be replaced is specified by the prime record key data 
item. , 


The "INVALID KEY" condition exists when: 


1. The access mode is SEQUENTIAL and the value contained in 
the prime record key data item of the record to be 
replaced is not equal to the value of the prime. record 
key of the tast record read from this fife» or 


2. The value contained in the prime record key data item 
does not equal that of any record stored in the file. 


The updating operation does not take place and. the data in 
the record area is unaffected (refer to the "INVALID KEY* 
Condition). . 
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The START Statement 


Function 

The "START" statement provides a basis for togical positioning 
within an indexed fite>s for subsequent sequential retrievat of 
records. 


| General Format 


T 
n 
Cc 
e 


{C INVALID KEY statement-1 LELSE statement-2)1] 


1 

{ C IS EQUAL TO ) | { 

C ¢ sna ) ] | 

. { ( IS = ) ] { 

START filecname ( KEY (¢€ IS GREATER THAN .) data*name 1] 1 
so { ees .< ee em ee ) ] I 
C ( IS > ) } 1 

C € IS NOT LESS THAN ) ] { 

C ( <a ) ] 1 

{ C IS NOT < ) J { 

{ ¢ aa ) ] i 

an | 

( 

i 

i 


NOTE 


he required relational characters “>"» "<"»/ and "=" are 
ot underlined in the syntax diagram above to avoid 
onfusion with other symbols such as “greater than or 
qual to". 


Syntax Rules 


de 


be 


Filename must be the name of an Indexed file. 


File-name must be the name of a file with SEQUENTIAL or 
DYNAMIC accesses 


Data~name may be qualified. 


The “INVALID KEY™ phrase must be specified if no applicable 
"USE" procedure is specified for file-name. 


If the *KEY" phrase is specified>, data-name must reference 
the data item specified as the record key associated with 
file-name. 
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General Rules 


ae 


f. 


Filename must he OPEN in the INPUT or [0 mode at the time 
that the "START" statement is executed (refer to the OPEN 
Statement). 


If the *KEY" phrase is not specifieds the relational operator 


"TS EQUAL To" is implied. 


The type of comparison specified by the retationat operator 
in the "KEY" phrase occurs between the key associated with a 


record in the fite referenced by file-name and a data item as 


specified in Syntax Rule e. The results of that comparison 
are as follows: | 


i. The current record pointer is positioned to the first 
Logical record currently existing in the file whose key 
satisfies the comparison. 


2- If the comparison is not satisfied by any record in the 
file» an “INVALID KEY" condition exists» the execution of 
the "START" statement is unsuccessful» and the position 
of the current record pointer is undefined (refer to the 
"INVALID KEY* Condition). 


The execution of the "START" statement causes the value of. 
the File Status data item» if any» associated with filename 
to be updated Crefer to I-C Status). 


If the "KEY" phrase is not specified» the comparison 
described in General Rule c uses the data item referenced in 
the “RECORD KEY" phrase associated with file-name. 


Upon completion of the successful execution of the "START" 


statement >» a key of reference is established and is used in 
subsequent Format 1 “READ” statements (refer to the READ 


statement). 


If the execution of the "START™ statement is not successful» 
the key of reference is undefined. 
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The USE Statement 


Eunction 


The “USE* statement specifies procedures for input-output error or 


exception handling that are in addition to the standard procedures 
provided by the MCP. 


General Forgat 


CEXCEPTION) 


i 1 
i i i. 
t USE AFTER STANDARD (eree="""") PROCEDURE ON 1 
( 2s. e2see CERROR:. > <)> 1 Sseeesea ' 
{ | (ss=s< ) ' 
| ar. - . i 
1 ( filecname-1 € filename 2 1] 2... )- I 
I C . , ) { 
i © INPUT ) t 
{ ( erene ) i 
] ( OUTPUT ) ! 
i ¢ manna w ) | 
I ( I70 ) I 
I ( -- ) 
| | 


Syptax Rules 


ae 


A “USE™ statements when present» must immediately foltow a 
section header in the DECLARATIVES SECTION and must be 
followed by a period followed by a space. The remainder of 


the section must consist of one or more procedural paragraphs 
that define the procedures to be used. ; 


The "USE" statement itself is never executed; it merely 
defines the conditions calling for the execution of the "USE™® 
procedures. 


The same fite-name can appear in a different specific 
arrangement of the format. Appearance of a file~name in a 
"USE" statement must not cause the simultaneous request for 
execution of more than one "USE" procedure. 


The words “"ERROR™ and “EXCEPTION” are synonymous and may be 
used interchangeably. 


The files implicitly or explicitly referenced in a “USE*" 
statement need not all have the same ORGANIZATION or ACCESS. 
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General Rules 


ae 


be 


Ce 


The designated procedures are executed by the ICS after 
completing the standard input“output error routines or upon 
recognition of the "INVALID KEY" or "AT END® conditionss when 
the "INVALID KEY” phrase or “AT END™ phrase» respectively» 
has not been specified in the inputtoutput statement. 


After execution of a “USE” procedure» control is returned to 
the invoking routine.» | 


Within a “USE” procedure» there must not be any reference to 
any non=declarative procedurese Conversely» in the 
non-declarative portion there must be no reference to 


procedure=names that appear in the declarative portion, 


except that “PERFOGRM" statements may refer to a "USE" 
procedure or to the paragraphs contained within the *"USE* 
procedure. . 


Within a "USE" procedures there must not be the execution of 
any statement that would cause the execution of a “USE 
procedure that had previously been invoked and had not yet 
returned control to the invoking routine. 


82 


The WRITE Statement 


Eunc tion 


The 


"WRITE" statement releases a logicat record for an output or 
input-output file. 


General Format 


WRITE record-name { FROM identifier 1] 


{ INVALID KEY statement-1 CELSE statement-2]] 


ayotax Rules 


ae 


b. 


Record-name and identifier must not reference the same 
storage area. 


The record-name is the name of a Logical record in the FILE 
SECTION of the DATA DIVISION and may be qualified. 


The “INVALID KEY" phrase must be specified if an applicable 
"USE" procedure is not: specified for the asscciated file. 


General Rules 


de 


The associated file must be OPEN in the OUTPUT or I-0 node at 
the time of the execution of this statement (refer to the 


OPEN Statement). 


The togicat record released by successful execution of the 
"WRITE" statement is no longer available in the record area 
unless the associated file is named in a "SAME RECORD AREA® 
clauses in which case the togical record is also available to 
the program as a record of other files. 


The execution of the “WRITE” statement with the "FROM® phrase 
is equivalent to the execution of: 


MOVE identifier TO record-name 


followed by the execution of the same "WRITE" statement 
without the “FROM™ phrase. The contents of the record area 
prior to the execution of the implicit MOVE statement have no 
effect on the execution of the “WRITE” statement. 


Ca 
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After execution of the "WRITE™ statement is complete» the 
information in the area referenced by. identifier is 
availables even though the information in the area referenced 
by record=name may not be Crefer to General Rule b). . 


The current record pointer is unaffected by the execution of 
a “WRITE” statement. 


The execution of the "WRITE" statement causes the value of 
the File Status data item» if any» associated with the file 


to be updated (refer to I-0 Status). 


The maxiauam record size for a file is established at the time 
the file is created and must not subsequently be changed. 


The number of character positions on a mass storage device 
required to store a togical record in a file may or may not 
be equal to the number of character positions defined by’ the 
logical description of that record in the program. . 


The execution of the “WRITE? statement releases a logical 
record to the MCP. a 


Execution of the "WRITE™ statement causes the contents of the 
record area to be released. The ICS utilizes the contents of 
the record key in such a way that subsequent access to that 
record may be made based upon the value of that specified 
record key. 


The value of the prig@e record key must be unique within the 
records in the file. 


The data item specified as the prime record key must be set 
by the program to the desired value prior to the execution of 
the “WRITE™ statement (refer to General Rule c).— 


Lf SEQUENTIAL access mode is specified for the files records 
must be released to the ICS in ascending order of prime 


record key values. 


If RANDOM or DYNAMIC access mode is specified» records hay be 
released to the ICS in any program~specified order. 


The “INVALID KEY" condition exists under the fottlowing 
circumstances: 


1. When SEQUENTIAL access mode is specified for a fite 
opened in the OUTPUT mode» and the value of the prime 
record key is not greater than the value of the prime 
record key of the previous record» or 


B4 


2- When the file is opened in the OUTPUT or I*0 mode» and 
the value of the prime record key is equal to the value 


of a prime record key of a record already existing in the 
file. . 


When the “INVALID KEY" condition is recognized» the execution 
of the “WRITE statement is unsuccessful» the contents of the 
record area are unaffected and the Fite Status data items if 
anyr associated with file-name of the associated file is set 
to a value indicating the cause of the condition. Execution. 
of the program proceeds according to the rules stated in the 
paragraph on the “INVALID KEY" condition (refer also to I[=0 
Status). 
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52428. Use of the ISAM Attributes 


When a disk file is first created (COPEN OUTPUT ..-. CLOSE LOCK)» 


four attributes are fixed and cannot be changed until the fite is 
recreated. These are: 


RECORD.SIZE CRSZ) 
RECORDS-BLOCK (RB) 
BLOCKS.AREA (B.A) 
AREAS CARE) 


The maximum number of records that can be contained in the file 
can he calculated ass 


Maximum Records = R.~B * BoA * ARE 


All of these attributes can be specified by the programmer via 
the “RECORD CONTAINS"» “BLOCK CONTAINS", and “FILE CONTAINS*" 
clauses. For ISAM files» the compiler generates two files for 
each ISAM “SELECT"™ clause (the data file and the tag file). The 
programmer does not have any direct control over the attributes 
of the tag file. The compiler sets the tag file RECORO.SIZE to 
the size of the record key plus either 3 bytes Cif $ RPGTAGS is 
specified) or 4 bytes. The RECORDS-BLOCK is calculated to get a 
block stze of 180 bytes or less- The AREAS ts set the same as 
that of the data file. Effective with the Mark VII.-0 compiler», 
the BLOCKS.AREA is set to insure that the tag file can nots as 
many records as the data file. For examples 


T“BeA=CD“R-B*OTB.-AD/T“R-BtCif any pewaander then 1 else 0) 


where "T=" means “tag file™ and "D=-" means “data file”. Extreme 
caution should be used when changing any of these attributes via 


the *"MODIFY* or “FILE™ statements. If the data file is changed» 
the tag file must be changed correctly. 


524295 %ISAM File Recovery 


When a record is added to an ISAM file» the compiler. must 
generate code to do two WRITEs» one to the tag file dnd ohe to 
the data file. This immediately brings up some potential 
problems in the event of abnormal end-of-job. 


Currently the code generated by a RANDOM WRITE 1s as follaws? 


a» WRITE the tag record. Do not request any error reporting. 
This means that any error on the WRITE (Parity». Incomplete 
I/O» Full File) causes the MCP to terminate the progam 
immediately. 


be WRITE the data record. Request error reporting. In the 


event of an error» the program takes the INVALID KEY branch 
or the USE routine. 


86 


The above code sequence could result in the tag file having a 
record that points to a nonvexistent record in the data _ file. 
This problem witl be fixed in a future retease. . 


In the WRITE of the data file» the error reporting requested and 
action taken depends on the presence of an INVALID KEY statemente 
a USE routines or both: 


ae INVALID KEY = Report on EOF (Full File). Return a status 
of 10 (should be 24) and take the INVALID KEY branch. 


be USE Routine - Report on Parity. Return a status key of 10 
(should be 30) and enter the USE routine. 


Ce INVALID KEY and USE Routine - Report on EOF or Parity. If 
Parity» return a status key of 30 and enter the use 
routine. If €OF» return a status key of 10 (should be 24) 
and take the INVALID KEY branch. 


The erroneous status key values will be corrected in aie future 
release. 


If an error occurs and reporting of that error has not been 
requested» the MCP terminates the program with the fotlowing 
messages . 


NO PROVISION FOR <error> ON FILE <file-name> 


If the failure occurred between the WRITE of the tag record and 
the WRITE of the data records the EOF-POINTERs on the two files 
are different. Two choices are available at this point: either 
reload both files or copy the tlarger file (Cdisk-to-disk) leaving 
out the extra record (for example» use DMPALL with the INCLUDE 
<EOF POINTER - 1> option.~j If the EOF.POINTERsS are the same» the 
only problem is that the tag file has not been sorted. It is 
therefore possible to sort the tag file Cusing the SORT utility 
program) and continue processing. 


It should be noted that if corruption occurs and no recovery is 
effected» the next program to use the fite may not detect the 
error. The onty check made is during the building of the rough 
table CACCESS MODE IS RANDOM or START is used). The records read 
in building the rough table are sequenced=checked and a fatal 
error occurs in the event of a sequence error. Howevers if the 
few records read by the “build rough table” routine are in arders 
or no rough table is built» then the program proceeds. In this 
Case@e records that are present may not be found and duplicates 
may be introduced. 
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Se42l0- Efficient Use of ISAM Constructs. 


COBOL is required» by ANSI*74 syntax» to check for duplicates at 
the time of the WRITE. The compiler generates code so that 
before each RANDOM WRITE the file is searched for duplicates. If 
no duplicate is found the record is written» but if the record 
already exists. in the file» the INVALID KEY branch or USE routine 
is taken with the status key set to 22. | 


As an examples assume a simple file maintenance program that 
accepts "add“» “change"» and “deltete™ records. In COBOL the 
efficient way to handle this case would be to do a “*keyed* read 
only if the record type is a "change" or “delete™. If the record 
type is an “add"» then do not do a READ; do a WRITE with an 
INVALID KEY statement and a STATUS KEY clause. If the record is 
a duplicate» the INVALID KEY branch is taken and the status key 
is set to a 22. This allows only one search of the fite Cinstead 
of two) to be performed for each "“add"-type record. 


COBOL has two methods for creating an ISAM files either Output 
ordered (sequential) or Random. It is not possible to 
sequentially write an ISAM file with the records unordered. 
Unless care is taken» this may result in programs that run 
extremely slowly» as described in the following examples. 


The first example deals with a "load" of an ISAM file from an 
unordered source. If the file is opened QUIPUT with an access 
mode of RANDOM» the program runs very slowly. As each record is 
written the ISAM routines must check for a duplicate record in 
the file (note: an optimization has been incorporated in the 
ISAM routines where the check for duplicates is not done if the 
‘record to be added is greater than or less than any record 


previously added). If the file is being written in a random 
manner » before the nth record is written» the n-1 previous 
records aust be read. In the worst case» the addition of n 
records can result in 2n writes (tag and data) and the summation 
of 2n-m where m varies from 2 to n_ reads. For examples the 
addition of 6 records could take 12 writes and 4+3+2+1 reads. 
This can obviously be a very slow process for targe files. For 


large files» it is much better to first sort the input file and 
then do sequential writes. | 7 


The second example involves removing certain records» flagged as 
“to be deleted™» from an existing ISAM file. The best method of 
handling this is to open the existing ISAM file INPUT SEQUENTIAL 
and open a new [SAM file OUTPUT SEQUENTIAL» then READ and WRITE 
sequentially. The READS may cause some disk arm movement if the 
data records are randoms but the WRITEs witt be very fast. This 
method gives the added advantage of ordering the data records in 
the new files» providing faster access in atl future sequential 
access CaseSe 
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22e4e,1-2 %$ISAM Subroutine Segmentation 


Effective with Mark VII.0» the COBOL compiter automatically 
segments the ISAM-generated file~handling subroutines. It is 
necessary to recompile existing ISAM programs in order to have 


seqmented subroutines» but old programs need not be recompiled if 
segmentation is not important. 


The segmented subroutines start in the first segment higher than 


the highest user seqment. For example» if a program has user 
segments "O» 1» 2» and 3" and two ISAM files» then the ISAM 
subroutines are in seqments 4 and 5- If the program also has 


exponentiations then the “exponentiation” subroutines are located 
in segments 6 and 7 (the two highest segments generated). 


5240122 Specifying the “VALUE OF CORE-INDEX" 


The specification of “integer-1" in the "VALUE OF CORE-~INDEX"™ 
option is in “bytes*. If the value specified is too small» then 
disk activity increases and throughput decreases. If the value 
specified is too targe» then memory is wasted. There are several 
calculations necessary before an arbitrary value should be 
assigned. These calculations are in the format shown in the 
following formulas: 


Rough table entries = CORE-INDEX / RECORD.KEY.-SIZE 
TAG-RECORD-SIZE = RECORD.KEY.SIZE #* Cif & RPGTAGS then 3 else 4) 
TAGeRECORDS-~BLOCK = 180 / TAG-RECORD-SIZE 


When. the number of rough table entries equals the number of tag 
file blocks» minimum disk activity is achteved to secure the tag 
record that holds the key requested. The rough tabte is binariltly 


searched to find what part of the tag file holds the key. That 
partition of the tag file is then binarity searched (by randomly 


reading the tag records) until the record key is either found = or 


it can be determined that the requested key does not exist. 
Therefore the optimum CCRE“INDEX Ctowest memory for the towest 
physical I[/0 activity) may be found as: 


Optimum CORE-INDEX = CTAG-E OF /TAG.RECORDS~BLOCK)*RECORD-KEY.SIZE 


Increasing the CORE“INDEX beyond this value (up to TAG.EUF * 
RECORD.KEY.-SIZE) will reduce the number of logical 1/0 
operations» but will not decrease the number of physical J/0O 
operations. Increasing the CORETINDEX further wastes memory. 


Example: 


FILE CONTAINS 36 BY 540 RECORDS 
BLOCK CONTAINS 6 RECORDS 
RECORD.KEY.SIZE 15 4 BYTES 
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Assuming that the file is full (CTAGEQF=19440)> applying the 
previous formulas results in the following: 


TAG-RECORD.SIZE 
TAG RECORDS .BLOCK 
Optimum CORE*INDEX 


8 bytes (no $ RPGTAGS) 
22 
32532 bytes 


WoW fi 


If atlocation of 3532 bytes for the rough table is considered 
excessives the following formula may be applied to decrease’ the 

size of the rough table and stilt achieve a high degree of 
efficiency: 7 


New CORE“INDEX = Optimum CORETINDEX/C(2**n)-1) Crounded up) 


where "n™ varies from 2 by 1 until the new CORE-INDEX is an 
acceptable value. For example» if 3532 is too much» then divide 
by 3» giving L178. If this is stitl too high, divide by 7» 
giving 505» and so forth. . ; 
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6. BASIC 


6.1. Introduction. 


The Mark VII.0O release of BASIC contains no updates or 
enhancements to the current implementation. 


A supplement to this release document» containing complete 
documentation on BASIC» is available in the form of a printer 
backup file labeled DOCUMENT/BASIC. 


622. Known Errors and Restrictions. 


Gegele i 
The BASIC compiter does not generate a syntax error when arrays 
of different dimensions are assigned. 


Example: 


10 DIM AC10)» B52) 
20 MAT A=B 
30 MAT B=A 


The assignment statements should produce two syntax errorss 


however» they compile error-free» generating a run-time INVALID 
SUBSCRIPT error. : 
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7 ‘FORTRAN 


Tale Introduction. 


The Mark VII-0O release of FORTRAN features the implementation of 
free~format [/Q+ or stash editing. In addition» a number of 
syntactically incorrect constructs which previously failed to 
cause syntax errors are now diagnosed correctly. 


Z222 Enhancements. 


Leleale 

Truncation of dynamic memory to 2560 words in the object program 
Can now be overridden by using the $ DYNAMIC compiler option. 
For example» the following control statement will extenac dynamic 
memory to 3000 words: 


$ DYNAMIC 3000 


lefe2s 

Free-format I/05 or stash editingr has been implemented. 
Teaporary documentation is contained in paragraph 7.4.1. 

Leeds 


A new compiler options $ TRUNCATE» altows variable names to be 
extended to more than six characters without causing a syntax 


error. Such names are then truncated to six characters by’ the 
compiler. Care must be taken to insure that these truncated 
names are still unique. 

Le2e4s 


A new compiler option» $ C€NO} SUPPRESS» has been implemented to 


attlow suppression of warning messages on the output PvsE VG) The 
default is NO SUPPRESS. 


Leleda | 

Named BLOCK DATA subroutines are now permitted. To be bound ine 
the SBLOCK DATA subroutine must be specified in an EXTERNAL 
statement. For example: 


BLOCK DATA DAT1 
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fe32 Known Errors. and Restrictions. 


Ledels . 
The compiler fails to syntax duplicate identifier names in a 


COMMON statement> when the Last two elements of the COMMON are 
the duplicates. . 


Ledele 


A READ statement having the erroneous syntax: 
READ (€<unit>) <nametist 1d> 
rather than the correct syntax: 
| READ C<unit>» <namelist id>) 


generates acaltl to a non ~existent intrinsic ".RCSU" Cassuming an 
ordinary unformatted READ). The error is detected at bind time. 


Ladeades 


The NAMELIST name "DATA® Causes a number of irretevant syntax 
errors when used in an 1/0 statement. 


Laseahks _ 
The compiler is erroneously syntaxing a correct ASSIGN statement. 
For example» the statement: 


ASSIGN 46 TO NASSGN 
results in the following error message: 


ERROR MAX LENGTH OF IDENTIFIER IS 6 CHARACTERS 


.eerrr 

The assignment | statements "F2 = 99999999999999999—" and 
"F2 = .999999999E+10" fail to receive a truncation error message. 
L23202 : . . 

The format “F1.8" compiles without syntax errors» but upon 
execution produces only one position of output. 

Leelee 


Listing: a FORTRAN backup file under controt of CANDE correctly 
Lists the file» but results in the following warning message: 


WARNING: RECORD SIZE IS GREATER THAN 133% TRUNCATION WILL OCCUR 
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£23282 : 
The FORTRAN compiler is erroneously syntaxing catls to 
subroutines whose names were passed as arguments. For example: 


SUBROUTINE BUGCERROR) | 
CALL ERROR CNAVY>TEST) 


Temporary fix: Use the EXTERNAL statement. 


Ze4- Temporary Documention. 
Te4e]d- Freeformat 1/0 (Stash Editing) 


Input Files 


Free~format input reads from the input file untit the 170 
variable list is exhausted. 


General Format 


a | READ Jom 1 
1 READ Cus/)o aan | 
i READ Cus/ ol)a i 


[(SsSe 4 SSeS Ree Sas eae Sa See a ee a wie | 
! where u represents a unit i 
{ numbers t is an action specifierl| 
1 Lists and m is an I/O variable 14 
1 list. ] 


Syntax Rules 


a» Values in the input file must be separated by commas. 


be Blanks Ceven embedded btanks) are ignored. 


General Rules 


ae The end of a physicat record terminates the current vatues 
and the next value is read from the succeeding physical 
record. , 


be Onty certain types of input are permitted for a specific 
type of variable: . 


Integer: I format 
Reals Ie Er Fo or DO format 
Double: I» Eo For or D format 
Complex: I» Ev» Fe or C format 
Logical: t format 
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ce Values of 0 or FALSE are the default if a blank or null 


field is read. 


Example 


LOGICAL 0 
READ C5e/eEND=50) TerI oO 


The data record might contain: 


1234.56%227 51 


Qutput Files 


Free~format output writes values to the output file until 


1/0 variable List is exhausted. 


General Format 


i WRITE Cus/)a 

1 WRITE Cur//)m 
i WRITE Cus*«/)am 
! WRITE Cur*//)am 
1 PRINT /om . 
i PRINT //om 

i PRINT */em 

| PRINT «//om 

i PUNCH />m 

! PUNCH //om 

{ PUNCH */om 

| PUNCH *// om 


J ww enw enw ene wea ees wm amen mwowae | 
ij where u represents the unit i 
i numbers and am is the I/0 1 
! variable list. an | 


General Rules 


the 


ae Values are output in. the most appropriate format with 


trailing zeros and blanks removed. 


be Values are separated by a comma and a blank if the 
slash is not included. 


ce Values are separated by tuo blanks if the second stash 


present (note that this output cannot te read 
free-format input due to the Lack of a comma). 


second 


is 
by 
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de. Values are preceded by "“<variable name>=" if the optionat 
asterisk is present. If the value is an expression or 
array elements "<EXP>" will be substituted for the name. 

e- If a value» the “<variable name>=" Cif required)» the 
preceding blank» and the trailing comma or blank cannot atl 
fit into the end of a particutar records they are alt 
placed in the succeeding record. 

_f. Literal strings up to 255 characters in length may be 
output using free-format 1/05 but each string must be able 
to fit within a single record. 

Exaaple 
LOGICAL D 
A= 27642 
I= 19 
D= eFALSE. 


PRINT «// Ax eD 


Execution of this program segment produces the following output: 


A=27 «2 T=19 D=F 


iIntrinsics 


Twenty~four intrinsics have been added to provide this feature: 


» ISSR Initiate a Serial Stashedited (free-format) Read 


«~ISSW Initiate a Serial Slash~edited (free-format) Write 
eRCAS Read a Comptex Array Stlash-edited (freeformat) 
eRCSS Read a Complex Scalar Stash-edited (free-format ) 
eRDAS Read a Double Array Slash-edited (free-format) 
«RDSS | Read a Double Scalar Stlash~edited (free-format) 
eRIAS Read an Integer Array Stash-edited (free-format ) 
eRISS Read an Integer Scalar Slashmedited (free~format ) 
eRLAS Read a Logicat Array Stashv-edtted (free-format) 
eRLSS Read a Logical Scalar Slash~edited (free~format) 
eRRAS Read a Reat Array Stash~edited (free-format ) 

oRRSS Read a Real Scalar Slashredited (free-format ) 
oWCAS Write a Complex Array Slash~edited (free~fomat) 
-WCSS Write a Complex Scalar Slashtedited (free~format) 
oWDAS Write a Double Array Stashwedited (free-format) 
eWOSS Write a Double Scalar Stash~edited (free~format) 
eWHAS Write a Hollerith Array. Slash-edited (free-format) 
oWHSS Write a Hollerith Scalar Stash-edited (free~format) 
oWIAS) Write an Integer Array Stlash-edited (free format) 
eWISS Write an Integer Scalar Stashcredited. (free-format ) 
eWLAS Write a Logical Array Stlash-edited (free-format) 
eWLSS Write a Logical Scatar Stash-redited (free-format ) 
oWRAS Write a Reat Array Stashcedited (free~format ) 


eWRSS Write a Real Scatar Stlash-edited (free-format) 
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Be. UPL 


Bele Introduction. 


The Mark VII.0 version of UPL adds no new constructs to the UPL 
language. Certain portions of the compiler have been recoded to 
increase efficiencys and atl known problems in the compiler have 
been corrected. | = * 


B8s22 Enhancements. 


— Beeele 
A probtem has been fixed in which variables appearing within 
DEFINE expansions were not always appearing in XREF Listings. 


Bavels ae . 

The FPB.PSEUDO boolean is now set by the compiler when a file is 
declared with “FILE_TYPE = PSR_DECK*"» eliminating the need to 
modify that file after compilation as discussed in this section 
of the Mark V.l release tletter. 


Betade 
The compiter now gives a syntax error if a "$ LIBRARY" card 
appears within a library file. 


| Be2ehe ee 

A problem has been fixed in which the compiler would fait if a 
token ended in column 72° =and the next source image was a "$* 
statement. 


Bele2e a 
Several unusual and erroneous syntactic constructs which caused 


the Mark VI.1 UPL compiler to terminate with an [INVALID CASE or 
INVALID SUBSCRIPT error are now detected and diagnosed with error 


MESSADJCS« 


If a “DEVICE=<hardware type>" phrase is not included in a file 
declaration statements» the hardware wilt default to disk tather 
than to tape as in previous releases of UPL. 


Bslels . 

"ON" clauses (CON FILE_LOCKED> ON FILE_MISSING) are now permitted 
in "OPEN" statements for files of hardware type "REMOTE". In the 
Mark VI.1 release of UPL» such clauses would cause syntax errors. 


822282 | : 

The algorithm for computing dynamic memory has been corrected>s 
avoiding the targe values the compiler would erroneously assign 
in certain cases. 
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Be229e | 
The compiler with no longer terminate with an INVALID SUBSCRIPT 
error if an “&" statement has no syntactic tokens following the 
ampersand. . 


822210 - : 
SOL Intrinsic #45 which handtes the "CONVERT™ function» now uses 
the "TRANSLATE" - statement to perfora bit-to-character 


conversions» substantially improving the execution speed of this 
function. 


8-2-1412 

A problem has been fixed in which a percent sign appearing in 
coluan 72 of a source image which was part of a CEFINE definition 
caused the next source image to be skipped when that DEFINE was 
expanded. 


8222122 | — | 
The compiler now emits a warning if the number of characters in a 
DEFINE is more than 4000» but fewer than the Limit of 4095. This 
warning is intended to alert the programmer to the possibility of 
future developnmant problems if the definition is increased in 
size. 


Betehds 
An error message will be emitted if the total stack size within a 
compiled program exceeds 128,000 bytes. 


822el4e 
The compiler wilt no longer abort if the syntactic token "FINI® 
appears in columns 69°72 of a source image. 


Salelis : 

The occurrence of any unquoted speciat character other than "/" 
on a *$ LIBRARY*™ record is now syntaxed. For examples the common 
error of accidentally ending such a record with a semicolon 
(causing the compiler to incorporate the semicoton as part of the 
library file name and then to attempt to open the wrong file) can 
no longer occur. 


822216. 


The compiler now properly hendles a ey hears dectaration of type 
"RECORD™. 
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823. Known Errors and Restrict ions. 


8.3.1. ; ; 

A "STATUS" inquiry from a remote terminal can sometimes "catch" 
the compiler between passes» causing meaningless information to 
be returned in the sequence nuaber portion of the response. This 
can sometimes cause unpredictable transmissions or hangs if the 
information generated includes special data comm characters, 
requiring a “?CQ" to clear the transmission. 


UPeree 

The user of extended arithmetic operations shoutd be aware of the 
incorrect detection of field overflows beyond the 652535~bit 
maximum Capacity of UPL. Refer to the SOL interpreter section of 
this release document for details. 


823235 

The “COMPILE_CARD_INFO”™ statement documented in the MARK VI.1 
release letter is in fact not a part of the UPL Language and the 
documentation should be ignored. The UPL Language is designed to 
be isolated from system-dependent functions» and this includes 
COMPILE_CARD_INFO» whose information content and format is highly 
changeable between software releases. A statement similar in 
intent» but returning consistent information in a nonschanging 
formats is planned for a future release. | 


Be4s Temporary Documentation. 


Behate 
A subscript is not permitted with the queue family name when 
using the "READ_OK" variant of the WAIT statement upon a queue 


family. This form of the WAIT statement examines all members of 
the queue family» waiting for a message to appear in at least one 
queueée Thus it is invalid to attempt to specify one = parttcular 


family member in the “"WAIT™ statement. 


824 a2 

A "™MESSAGE_COUNT™ statement ts mandatory to ensure correct 
results on a following "WAIT statement waiting for 
"Q WRITE_OCCURRED"”. | 

824232 | | 


The "ON FILE_LOCKED" clause documented in the UPL manual as part 
of the "SEARCH _DIRECTORY™ statement ts not» .and never has been 
functional. As the number of users is one subfield returnad with 
this statements the imptementation of the “ON FILE_LOCKED"™ ctause 
would be redundant» and is hence not planned. 


824245 


The following is a comptete List of altowable file attributes: 


Be 


In 


ALL_AREAS_AT_OPEN 
AREA_BY_CYLINDER (not implemented) 
AREAS 

BUFFERS 

DEVICE | 
END_OF_PAGE_ACTION 
EU_INCREMENTED 
EU_SPECIAL 
FILE_TYPE 
INVALID_CHARACTERS 
LABEL 

LABEL_TYPE 

LOCK 

MODE 

MONI TOR_INPUT_FILE 
MONITOR_OUTPUT_FILE 
MULTI_PACK 
NUMBER_OF_STATIONS 
OPEN_OPTION 
OPTIONAL 

PACK_ID 

PROTECTION 
PROTECTION_IO 


RECORDS 


REEL: 


REMOTE_KEY 


SAVE 
SERIAL | 
TRANSLATE 
USE_INPUT_BLOCKING 
USER_NAMED_BACKUP 


VARIABLE 
WORK_FILE 


Sed 


the absence of a "RECORDS" phrase 


in a file declarations 


following default values are assigned: 


As 


Device | Record Size 
DISK 180 bytes 
TAPE 80 bytes 
any 96°column CARD device 96 bytes 
any other CARD device . - 860 bytes 
PRINTER 132 bytes 
all other devices 72 bytes 
always» the USE_INPUT_BLOCKING clause 
FPB.DEFAULT boolean to be set for the file» 


record size of an already~existent file fopened 


instead of the above values. 


witt cause 
causing the actual 


INPUT to 


be 
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the 


the 


used 


10C 


9. DMSII 


Dele Introduction. 


The major new feature in the Mark VII.0 release of OMSII is the 
implementation of record-level lockout on OMSII data set records. 


In addition» a restart capability has been added to _ the 
reorganization programs» several changes have been made to DASDL 
syntax» and many problems from previous releases have been 


corrected. 


9e2e Enhancements. 


Qeeele . 

The following problems reported in the Mark VI.1 release tetter 
have been fixed (the numbers in parentheses refer to the 
paragraphs in the Mark VI.1 release tetter which originally 
described the problem): 


ae “"WHERE™» "VERIFY"» or "REQUIRED" statements which reference 
data items larger than 1000 bytes in length will no Longer 
cause an MCP NAME/VALUE STACK OVERFLOW hatt:. (17.3.1). 


be The population specified for an automatic subset is now 
used by the DASDL compiler to calculate physical parameters 
for that subset; earlier compilers used the poputation of 
the data set for these calculations (17.3.2). Note that 
any automatic subset generated under Mark VI.1 or earlier 
versions of DASDL» and which had an expticit POPULATION 
statement which differed from the population specified for 
the data set» wilt require reorganization if an UPDATE or 
REORGANIZE compile is performed on.the data basee This can 


be prevented by setting the population for the subset equal 
to that of the data set» or by removing the POPULATION 


statement from the subset declaration. 


Ce A second *$ MERGE" statement is now ignored by the OASDL 
compiler (€17.3.3). 


de. The DASDL compiter no longer generates COBOL library files 
in which a period precedes the first "02" item (17.3.4). 


ee Although DMSILI normatty does not perform a complete close 
on a data base untit alt users have closed it» if all 
update users have ctosed the data base» but there are still 
inquiry users active» a “pseudo close” is performed on the 
data base dictionary to reflect the fact that no more 
updates are being done. This prevents the data base from 
requiring recovery if a system failure shouid occur before 
the data base becomes inactive (17.3.7). 
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f.~ Prime data sets for which. segments per area is not a 
multiple of segments per block can now be accessed in data 
set order. The. problem within the DASDL compiler which 
created this situation has atso been corrected (17.3.8). 


g- The correct set of COBOL library files» Labeled 
 “E<data~base*name>/<data~set-name>"» will now be present on 
disk after a reorganization in which a manual subset is 
added to» or deleted from» a data set which is also being 
PURGED €17.3-9). . 


he DEADLOCK is now detected if a program has multiple invokes 
of a data set and attempts to MODIFY a record by the second 
invokes when that record is already locked by the _ first. 
invoke (17.3210). . 


222222 
The following problems reported by nVStEs Flashes since the Mark 
VI.~1 Release have been corrected: 


ae The Disk Search Operator is now retried automatically by 
GISMO if an 1/0 exception condition occurs (Flash #186). 
This has required that the Search Op be rewritten to bring 
the entire index table into memory before proceeding with 
the search. In previous releases» the search was performed 
on each individual index entry as it was read into memory; 
the memory required for this was just the length of a 
single entry. 


be The INITIALIZE statement | in DASOL is now optional in allt 
compiles. The DASDL compiler assumes INITIALIZE unless a 
compile for syntax is performed (Flash #191). 


ce The OASDL compiter will now syntax an attempt to change the 


attributes» during a reorganize compile» cf any item which 
is used as a KEY for an ordered manuat subset (Flash #192). 


d. Audit and recovery may now be added tos or deleted from» a 
data base during a reorganize DASDL compile (Flash #195). 


Refer also to paragraph 9.2.6 betow for further information 
relative to items (€b) and (d) above. 


922232 . EY gt 

Data set records are now Locked at the record tevel. Prior toa 
Mark VII.O OMSII» if a physical block contained more thah ane 
‘data set racords and one of those records was locked by a usere 
“no other user could access any of the records in that physical 
block until the first user had released the olock. Under Mark 
VII-O DMSII» onty the specific record requested by the user 
program is Locked. In additions the tock ts nonv-exclusives that 
is» while arecord is tocked» other users may perform a FIND on 
that record without receiving a DEADLOCK exception. 
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The implementation of record-level tockout has required several 
Changes to the aanner in which OMSII allocates and manages 
buffers while processing a data base. The Lock Descriptor Table 
and the Lock Descriptors themselves have been changed. The 
function served by Lock Descriptors prior to Mark VII.0 is now 
performed by Buffer Descriptors and a new type of Lock 
Descriptor. The first 144 bits of each OMSII buffer contains the 
Buffer Descriptor for that buffer; this descriptor identifies 
the disk address of the data contained in the buffers» the number 
of users for the buffer» and the structure number for the buffer. 
In addition» there is a Lock Descriptor present for each record 
which is currently lockeds this descriptor identifies the buffer 
which contains the locked records and further describes which of 
the records within that buffer is locked» to which user Cif any) 
the record is assigned» and to which of the three classes of lock 
the record belongs: - . 


ae User Lock. A user has explicitly locked the record by a 
MODIFY operation. Qnty data set records» both disjoint and 
embedded» can be tocked in this fashion. The records 


described by this type of Lock Descriptor are available to 
be read by other users Cnontexclusive lock). 


be. MCP Read. This is a temporary condition» used by ODMSII 
when reading information from disk. This type of Lock 
Descriptor is used to prevent the MCP Memory Management - 


routines from overtaying the buffer until ODMSII- has 
coapleted the current operation. The record described is 
not locked in the sense of being unavailable to other OMSII 
userSe 7 . 

ce MCP Lock. This is also a temporary conditions but the 
record described by this Lock Oescriptor is tocked 
exclusively. This is used by DMSII when a record has been 


updated by a partiatly completed operation.j Only the MCP 
can access the information in this record until the current 
operation completes» at which time the lock status of the 
record will return to the state it was in prior to the 
operation. 


There is a field within the Buffer Descriptor which allows OMSII 
to maintain the buffers as a linked tist within memory. Onty the 
MCP Memory Management routines can deatlocate CMSII buffers» at 
which time the descriptor for that buffer is delinked from the 
Buffer Descriptor chain. 


In previous OMSII releases» the BUFFERS parameter in DASDL was 
used to specify the Length of the Lock Descriptor Tabte. With 
the Mark VII.0 release» howevers the Length of this table is 
fixed at 20 Lock Descriptors» each descriptor being 90 bits in 
Length. If 20 is not enoughs additionat tables of 20 are 
allocated as required. Any overflow tock Cescriptor Tables 
remain in memory until the data base is closed. 
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Q22e 321s i | | | 

Because of the changes in the allocation and maintenance of the 
Lock Descriptor tables» as described abover the BUFFERS clause has 
been removed from the DASDL syntax. The compiter will ignore any 
attempt to set this parameter. 


Qaleabe2s 
The BUFFERS clause has been removed from the SM input message. 
Refer to paragraph 9.2.7 of this document for the new syntax of 
the SM message. 


2efeh4e | | 
The reorganization programs» DMS/REORG.READ and ODMS/REORG-WRIT>» 
are now restartable.. If the reorganization process’ was 


interrupted by a CLEAR/START or by OS5-ing either of the 
reorganization programs» the reorganization can be restarted by 
remexecuting OMS/REORG.READ. This can be done untess” the 
reorganization was interrupted for one of the following reasons: 


ae Either of the reorganization programs encountered an I/0 
exception condition in the temporary data base dictionary 
or in the reorganization control file. The temporary 
dictionary is labeted "#<data-base~name>/DICTIONARY: the 
DASDL Listing includes the name of the reorganization 
controt file. 


b. Any data base exception condition other than an IQERROR. 


Ce Reorganization program errors. 


de The number of areas for a file is being changed» and the 
new number of areas requested exceeds the number already . 
allocated. 


ee. Index sequential table overflow during a garbage 
collection. . 


The listings generated by the reorganization programs can be used 
to determine if the reason for the interruption was one of the 
above. If any of these conditions occurs» the premreorganization 
versions of any data base fites which were removed by — 
DMS/REORG.WRIT must be restored before the data base can be used 
or another attempt at reorganization can be mades this must also 
be done if the user decides not to restart a reorganization which 
is restartable. 


Both of the reorganization programs must be terminated hefare 
restarting OMS/REORG.READ. 
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In general» the user need not be aware of the particular phase of 
the reorganization being performed at the time of the 
interruption. However» there are a few situations in which the 
user must take some action before restarting the reorganization. 
The existence of these situations can be determined from the 
printed listing generated by DMS/REORG.WKIT. These situations 
are the following: 


ae If OMS/REORG.WRIT was in the process of changing the number 
of areas. for existing files (the message 
"BEGIN FILE AREAS CHANGE* appears in the Listing» but the 
message "END FILE AREAS CHANGE” does not)» alt of the data 
base files which were to have their areas changed must be 
restored to their prevreorganization state. 


be If DOMS/REGRG.WRIT was in the process of copying files  froa 
a work pack to the pack on which the files are permanently 
assigned», and an I[/0 exception condition occurred while 
reading the work file» then the reorganization programs 


must recreate that work file. I f any of the 
pre-reorganization files needed to recreate the corrupted 
work file does not exist in the new data base» but new 


files with the same names do exist in the new data base» 

DHS/REORG.READ will display a message that the newly 
created files with the same name must be saved» and the 
prewreorganization files must be retoaded. After the 
corrupted file has been recreated» the backup copies of the 
new files can be restored. 


ce. If the interruption occurs after ODOMS/REORG.WRIT has removed 
the old data base dictionary» but before it has changed the 
name of the temporary dictionary» the user can change the 
name» and it is not necessary to restart the reorganization 
programs. 


922232 

As described in paragraph 17.4.8 of the Mark VI.1 release letter, 
DMSIZT no tlonger maintains the control items RESTART TYPE and 
TRANSACTION COUNT within the restart data set record. 
Programmatic restart procedures which rely on the settings of 
these items must be rewritten before attempting to implement the 
Mark VII.0 releases as the results of such procedures are 
unpredictable. 


The DASDL compiler witlt treat these data items as having type 
NUMBERC(1) and NUMBER(6)», respectively. Additionally» users can 
change their data base descriptions such that the item types. for 
these fields have the above values» without being forced to 
perform a reorganization of the data base» The Mark VIII-O DASDL 
compiler will treat these data types as syntax errors. 
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22226- , 

In order to increase the compatibility of DASDOL syntax among all 
of the Burroughs DASDOL compilers» a major effort to standardize 
the DASDL tanguage is currently in process. This standardization 
has required that several changes be made to the DASDL syntax for 


the 6 1800/8 1700. Most of these changes are additions of 
synonyms for existing terms» and witt not dtirectty affect 
existing data base descriptions when an update or reorganization 
compile is performed. Howevers it is possible through use of a 


new dollar-card options» “STANDARD™» for the DASCL compiler to 
generate warnings whenever any syntax is encountered which does 
not conform to the standard syntax for the DASCL language. 


9e22Gelse | | 54 
The syntax of the OPTIONS statement has been expanded to the 
following: | . 


ono => OP TIONS CAUD I Tenner nnn nnn n enna nn n> penny 
an 

[r= >SET@s2-">1 

1 : t 

|=" >RESET<--> 


When the AUDIT option is used» the data base must contain exactly 
one restart data set. If the option is SET» CMSIT will maintain 
an audit trail of all updates to the data base. If the option is 
RESET» no audit trait wilt be maintained» but the restart data 
set must stitt be present. This ailows a user to selectively 
disable the auditing of certain processes» such as the initial 
load of the data base» when the amount of overhead required to 
audit the pracess and» if a failure shoutd occur» recover the 
data base and restart the process» make it more practical to 
bypass the audit and retoad the data base and start the process 
again. 


When AUDIT is reset» OMSII ignores any BEGIN or END“TRANSACTION 
requests issued by user programs. It is therefore possible» if a 
system is being debugged with AUDIT reset» to attempt OMSII 
operations which would have resulted in exceptions if AUDIT had 
been set. For example» an AUDITERROR would be generated if the 
program were to attempt to perform a BEGIN“TRANSACTION or data 
base CLOSE while in transaction state» or an END@“TRANSACTION 
while not in transaction state; if AUDIT were reset when any of 
these operations was attempted» no exception would be detected. 


AUDIT can also be SET or RESET through the SM input message. 
Refer to paragraph 9.2-7 of this documents as well as to the 
revised Software Operational Guide» for the updated syntax of 
this message. 
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Qelsbhed 2 : ; Gn: 

The following table Lists keywords which have been implemented 
for Mark VII.0 in order to conform to the standard syntax for the 
DASDL language» and which are synonymous with keywords used by 
the pre-VII.0 versions of the compiler. Opposite each entry in 
the table is the prevrVII.-0 synonym for the keyword; the DASDL 
compiler will include a warning in the tisting upon encountering 
these preVII.0 keywords if % STANDARD has been specified. 


Keyword Synonym 
AREALENGTH AREASIZE> 
FAMILYNAME | PACK 
TAPEPE PETAPE | 
MAXENTRIES POPULATION 


MAXRECORDOS POPULATION 


MAXENTRIES is used to specify the maximum number of entries for a 
set or subset» and MAXRECORDS is used to specify the maximum 
number of records for either disjoint or embedded data sets. 


Qe2sbe30 | | 
The syntax for the physical parameters AREALENGTHs BLOCKSIZE» and 
TABLESIZE has been changed to the following: 


“-=>AREALENGTH = <integer> “=""""">BLOCKS weet tseere=>/ 


“--=>BLOCKSIZE = <integer> --""-=->RECORDS totes sete =>/ 
" i 
Pm--OENTRIES<->1 
{ . { 
te"->TASLES<“"->1 
w-">TABLESIZE = <integer>er----=->ENTRIES se e--- Sees > J 


If $ STANDARD is set» the absence of the unit specifiers (BLOCKS>» 
RECORDS» ENTRIES» or TABLES) in any of the above will result in a 
warninge In the case of BLOCKSIZE» if the unit specified does 


not apply to the structure pveing described» a warning wilt also 
be generated. 


22f2Heohe 

INITIALIZE tis assumed whenever the DASDL compile is not’ for 
syntax only.-~ If $ STANDARD is set» DASDL witl generate a warning 
when INITIALIZE is encountered. 
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92228ede 
The syntax for set or subset declarations has been changed to the 
following: 


<set or subset>: 


1 1 { ; 1 
I--><subset>=-->I | I--»--<physical-option>-~>{ 


<set>; 


--><set-name> SET OF <data-set-name> diab of 


<subset>: 


-=><subset=name> SUBSET OF <data-Sset -namerq7o cece mene tenn meenwennne>/ 
! i 
1->WHERE <condition>=->1 


<key"structure>: 


woreeckey-st SCORCN ESS Te Se SSeS ee Se ee eS SS Se ae ee ee a ee ee, 
i | 1 | | : ' 
. . (<e eee se See e es ees Eee eee oe Se Sees = | ( 
iP eee | i i 
[ro reece neen2--=>DUPLICATES@-"-> 29-1 
{ t 1 ' I 
i 1~>NO->1 ! i 
I 1 t 
{ aee . i I 
fms L seer => INDEX RANDOM@ "e-em >I l 
i ] ' 
{~>INDEX SEQUENTIAL="-~>1 ! 
| 
1 
! 
] 


1 1 
1-> ORDERED LISTote----->1 


U-->UNGRDERED LIST corte snn tenner nnn eenencene satetetataneatatatetetate > 
i i 


The syntax for the <keyestatement> and <condition> is unchanged. 
<physical-option> refers to any physical parameters which may he 
applicable to the structure being described» such as LOADFACTOR>» 
PRIME» MODULUS» and so forth. Note that these physical 
parameters can appear either within the description of the 
structures as shown above» or at the end of the data base 
description» as in previous releases of DASOL. 
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If & STANDARD is Set» the keywords ORDERED and RETRIEVAL 
preceding the keyword SET» and the keywords ORDERED and UNORDERED 
preceding the keyword SUBSET,» will generate warnings. INDEX 
SEQUENTIAL is the default type for alt sets and automatic 
subsetse 


Because of these changes to the set and subset syntax» the 
TYPE=INDEX SEQUENTIAL and TYPE=INDEX RANDOM statements have been 
removed from the OASDL syntax. 


22220202 
The syntax for a data set has been changed to the ewitewina: 


<data~set>:s 


=<><datas6t-nane>-s-r=<"s4-oresecsenane eee oe ee -===DATA SET""> 
Ts eeeecntees ee 
(osaperiniee a 
1 =>STANDARO==>1 
nasa OE Renee 


-“=<><record=descri PCDPON Sete tet ee eet we we mem mena memamawad ze~>/ 
Z . ] 
Im--s--<physical-optian>-=>1 


The data set types of RESTART» ORDERED+ and UNORDERED are 
unchanged from previous releases. The data set type of STANDARD 
is the default» and describes a simple disjoint data set. 


As in the case of Sets and subsets» the <physicalr-options> are 
used to set any physical parameters for the data set» and may 
appear either with the data set description or at the end of the 
DASDL source deck. ; 


22228202 

Quoted comment strings may only appear between an item name and 
the type dectaration for that item (for example» between the name 
of a data set and the keywords DATA SET» or between a data item 
nage and the keyword NUMBER). The DASDL compiler wilt generate a 
warning tf any quoted comments are encountered anywhere in the 
data base description other than as specified. 


* 92226282 

The user can designate permanent OASDL options by coding two 
consecutive dottlar signs ($$) in columns 1 and 2 of an option 
records these options are included in any new DASDL source file 
created by the inclusion of a NEW collar option within the source 
file. A single dottar sign in column 1 of the option record 
indicates a temporary option; the options on such a record are 
not included in any new source file which ts created. 
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92226298 . 

The keywords SET and RESET may precede any DASDL option. The 
keywords NO and RESET are synonymous» and have the effect of 
resetting the following option. SET enables an option» and is 
assumed if an option appears without an explicit SET» RESET,» or 
NO. 


222262192 
The following is a List of doklar options which have been added 
to the DASDL compiler for the Mark VIT.0 Release: . 


DEBUG This option causes the DASDL compiler to 
include its internal reorganization control 
information in the Listing generated during a 


reorganization. compile. This option shoutd 
only be set when problems with reorganization 
are encountered» and only for the purpose of 


assisting the Burroughs software development 

and support personnel with the isolation of 
such problems. Due to the nature of the 
information generated and the Likelihood that 
such information Cand the format in which it is 
printed) may change With each releaser 
Burroughs does not: intend to provide and 
maintain documentation concerning decoding of 
this information. 


INCLUDE <filevid> This option allows specification of a tibrary 
file to be included in the data base 
description. The file specified by <file-id> 
must be present on disk» and must consist of 
‘one or more DASDL source statements. The DASDL 
source statements within the tibrary fite can 


include any dollar option statements other than 
another INCLUDE» or a VOID statement. 


INCLNEW When enabled» this option instructs the DASOL 
compiter to include any source statements 
processed as a result of an INCLUDE option 
within any new source file generated by means 
of the NEW option. 


LISTS This option causes alt temporary DASDL option 
statements to be included in the compiler 
listing. This option has no effect if the LIST 
option has been disabled. 


LISTINCL This option causes all source statements 
processed as aresult of an INCLUDE option to 
be included in the compiler listing. This 


option has no effect if the LIST option has 
been disabled. 


SEQUENCE <b> <ti> This is the same as the SEQ option. If 
. specified>, this option causes the DASDL 

compiler to resequence the source statements. 

{f NEW is atso enabled», the new sequence 

numbers are permanently assigned to the new 

source file. If specified» <b> is used as the 

base for the mew sequence numbers; this base 


STANDARD 


WARNSUPR 


UPDATE <db-id> 


PAGE 


DELETE 


Qe2ebelis 
If $$ STANDARD 


defaults to "00001000". If specified» <ti> is 
used as the increment for the new sequence 
numberss the default increment is +1000. 


This option causes the OASDL compiler to 
generate warning messages when it encounters 
Syntax which does not conform to the standard 
syntax for the DASOL language. 


This is the same as the SUPPRESS option. 
Warning messages are suppressed in the compile 
Listing. 


The UPDATE option is the same as in previous 
releases. However» the <db~id> can be used to 
change the name of an existing data base from 
<dbid> to the mame on the DASDL COMPILE 
control statement. 


This option immediately causes a page advance 
in the DASDL listing. 


When enabled» this option causes source input 


records in the secondary input file (C(™SQURCE™) 
to be discarded by the DASDL compiler. This 
option can only appear on a source image in. the 
prirwary input file ("CARDS")» and has no effect 
untess MERGE was enabled. The merging process 
is not altered by this options but the source 
Statements in the secondary file are ignored 
until the DELETE option is disabled. If a new 
source file is being created, the deleted 
records will not appear in that file. 


specified and an attempt is made to set the 


BUFFERS parameters a. warning is generated. 


Qelels . | 
The syntax of the SM input message has been changed to the 
following: 


“-->SM <dat ambase*Namer meta tart et eet eee enn enn eens enenn- > 
i | 
I-->0N <pack=name>=~>1 


neem > SY NCPOLN [24s eer sees SE eS Ce ae a ee ee Meee See Se >/ 
i | { 1 
I-->CONTROLPOINT<-~>1 t--><integer>-->] 
1 ! 
"SAUNT Tet eee eee ere eee ee ae ser ee ees S>:{ 
I 1 
[e=sSE laces" > 
1 { 
I"">RESETo“->1 


If the data base does not have AUDIT specified in the DASDL 
sourcery the MCP will not perform the SM. The data base must be 
inactive in order to change any of the settings. If no <integer> 

is supplied for SYNCPOINT or CCNTROLPOINT» or if netther SET nor 
RESET is specified for AUDIT» the current setting of the 


parameter is displayed. The data base does not need to be 
inactive to query the settings of these parameters. 
222282 | 


The presence of an active multi-line control will no longer cause 
unpredictable results when using the SM input message. 


Qale2s 
The syntax of the DB input message has been changed to the 
following: ; 


wees) Poet es ee ween ae eee e eam arena sanwemoene)/ 


i { 
i--><data~base-name>~~~>1 


If <datacbase-name> is supplied» and that data base is actives 
the MCP will display the current vatues of the data base 
statistics normally displayed when the data base is physically 
closed. 


22.2219 

The “DATE.-COMPILED™ field within the Program Parameter Block 
CPPB) of the reorganization programs with reflect the date of the 
reorganization DASDL compile. 


Qo2shie 

A “FIND AT KEY" on an ordered set or automatic subset which 
specifies a key value higher than any key in the index will no 
longer result in wraparound on the index if the next operation 
on the index is a "FIND NEXT". 


2e22212- | 

Quoted comments which end in cotumn 72 of a eODASDtL source 
statement will no longer cause DASOL to terminate with an 
INVALID SUBSTRING error. 


2e2eh3- . 

When processing indexed structures» DMSIL now releases any 
intermediate index tables as soon as those tables. have been 
processed. For index random structuress only the base table and 
current overflow tabte will be locked in memory. For index 
sequential structures» only the root coarse table and current 


fine table will be tocked for a FIND or MODIFY operations for an 
update operations any intermediate coarse tables also affected by 


the operation will be tocked. Att index tables are released at 
the end of an operation. 
Qe2elase 


The DASDL compiler no longer generates incorrect sequence numbers 
if a sequence number appears in cotumns 73°80 of the dollar 
statement containing the SEQ option. | 


9e2el15- 

The DASDL compiter no Longer terminates with an INVALID SUBSCRIPT 
if a special character is encountered while scanning for the 
beginning of a token. 


922-16. 
The comma between key specifications and the population statement 
for manual subsets is now optional in the DASDL source deck. 


Qe2ehls ea 

The DASDL compiter no tonger generates invalid Next Available - 
Highest Open CNAHO) information for non=prime data sets having 
more than 20 areas. 


922218. 
Unpaired parentheses in a key clause are now detected by the 
' DASDL compiler. 


222192 


DMSII now resets the SEARCH-NeLINK.COUNT to zero when a data base 
is initially opened. 


2222202 

Due to the rewriting of the MCP Memory Management routines»s all 
DMSII buffers are now overlayed only by these routinese Prior to 
the Mark VII.0 release» OMSTII buffers. could be overlayed by 
either OMSII or the Memory Management routines. As a result of 
this» atl known problems with I/0 exception handling have been 
corrected. This includes the following: 


ae A NOTFOUND exceptions rather than an IGQERROR» was returned 
to a program. 


be OMSIL was displaying the following message: 
IG ERRGR - DMS WRITE ON STRUCTURE NUMBER <nn> 


However» the programs currently accessing the data base 
were not forced to. terminate» nor was Dump Recovery 
required. 


Qale2ls 

The DASOL compiler now uses paged arrays exclusively for atl of 
its tables. While this can cause compile speed to be much more 
sensitive to the amount of dynamic memory assigned» this has been 
done to eliminate alt of the problems which arose in previous 
versions of the compiler due to errors in the compiter's internat 


memory @anagement. The problems corrected py this change include 
the following: ; 


ae The DASDOL compiter would generate different results» 
depending upon the order of the source statements. 


be The DASDL compiler would abort» after displaying the 
message: 


wate COMPILER ERROR AT <seq-no> 
ce The DASOL compiler would hang tn a toop. 


Qe2e22s 
DMS/REORG- WRIT no tonger terminates with a NAME/VALUE STACK 


OVERFLOW when purging an index which is stored ina fite with 
other indexes. 


QeZe2se 

When performing an update or reorganization compite»s the DASOL 
compiler now compares WHERE and VERIFY conditions for strict 
equality first» and if that comparison failse the compiler then 
checks for equivalence. In previous releases of the compilers» 
the test was only for equivalence- Because of the test for 
equality» update and reorganization compiles using the Mark VII.0 
DASOL compiler require less time and dynamic memory than similar 
compiles using earlier versions of the compiler. 
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Qe2e24e . 
The DASDL compiler now allows duplicate data names within a data 
base descriptions with the following restrictions: 

ae Structure names must be unique within the data base. 


be Data names for items used as key fields must be unique 
within the data base. | 


ce. Data names for items not used as key fields must be unique 
within each data set. 4 


Known Errors and Restrictions. 


ho 


23 


eRe ey ’ 
n MCP INVALID SUBSTRING halt (L=3000006a3) can occur if 


2 
A 
CSPLITFACTOR) x (Entries per Coarse Table) 


for an index sequential set exceeds Sill» or if either LOADFACTOR 
or SPLITFACTOR for a set is 1002. 


Ie3scZe 

When = processing sequentiatly through an Ordered Set or Automatic 
Subset» if a NOTFOUND exception is returned on a_ FIND NEXT 
operation» the currents for the structure will be in the same 
state as if the data base had just been opened. That is» another 
FIND NEXT at this point will return the first record in the set 
(wraparound). A FIND PRIOR at this point is invalid» returning 
a NOTFOUND exception. . 


Ge be3e 

The DASDL compiler may terminate with an INVALID SUBSCRIPT when 
generating the code to perform “*REQUIRED™» “WHERE™ and "VERIFY" 
checking» if the amount of code necessary to perform all of these 
operations exceeds 65535 bits. The code generated by DASDL is 
bound into the MCP at data base open time» and the Limit of 
65*535 is a function of the SDL S-machine. 


223242 
An MCP CONTROL STACK OVERFLOW halt CL=230000029) can cccur if disk 
1/0 errors occur during data base CLOSE. 


Qadeds | 

When *$ COSOL* is specified in the DASDL source file» tha OASAL 
compiler generates a syntax error if any of the reserved words 
Listed in appendix A of the CQBOL manual are encountered. This 
includes att of the reserved words which are identified as "for 
future use or standards requirements"» even though the COBOL 
compiler itself daqoes not generate syntax errors upon encountering 
these words. 


9.42 Temporary Documentation. 


Qe4hels | 

Because of changes which have been made to the data base 
dictionary formate a $ CONVERT DASDL compile must be performed 
before a Mark VI.~«1 data base can be accessed with Mark VII.O 
DMSII. As was done in the Mark VI.-1 releaser the 4% CONVERT 
statement should be the onty record in the CASDL source file. 
Existing COS80L programs can access a data base under Mark VII.C 
without being recompiled; however» if the data base uses Audit 
-and Recovery» any update programs must conform to the restart 
procedures outlined by paragraph 9.2.5 of this document and 
paragraph 17.4.8 of ene Mark VI.1 release letter. 


Qe4ets 

Because of the changes to the data base dictionary mentioned in 
paragraph 9.4.15 it is not possible to process a data base under 
the Mark VI.1 release of DOMSII after it has been updated by the 
Mark VII.0 release. Also» due to changes in the format of DMSII 
audit file records» it is not possible to perform a Dump Recovery 
under the Mark VI.1 version of RECOVER/DATA.BASE using audit 
files created by Mark VII.0 OMSII. . Therefore» the only way’ in 
which a user can return to the Mark VI.1 release after having 
processed a data base on Mark VII.0 is to reprecess att updates. 
which had been performed under Mark VII.0 against the Mark VI.1 
data base. : . 


224232 
If a data base dictionary resides on a user ere DMSII does not 
consider the packcrid to be part of the data base name. 


Therefore» a user cannot have two data bases open with the same 
data base namer even though the data base dictionaries reside on 
separate disk packs. When a program attempts to open the second 
data bases DMSII witt assign the previously open data base to 
‘that user» causing Version Errors. If 3 NO VERSIONCHECK was set 
in the DASDL compile» however» the results are unpeediebanhes 
This is considered a permanent restriction. 


Gedeine So. gt | | 

For sets and subsets which allow duplicates» DMSII does not 
retain the duplicate occurrences of a key in the order. in which 
the entries were added to the set or subset. If this order is 
required» a key field must be added to the key specification for 
the set in order to make such duplicates unique. OMSII also does 
not guarantee that disjoint data sets and unordered tists 
Cembedded data sets and manuat subsets) will be returned jin the 
order in which they were added to the data base. 


QeSsd0 . 

Any ODASDL option which requires a parameter must be the tast 
option on a doltar record. This includes the TABLESIZEs» UPDATE> 
- and INCLUDE options. 


DaesOe : 
The following options can.only be set or reset prior to the first 
source statement in the DASOL source file Ci.see» the first 


non-dollar statement): CONVERT> FILE» MERGE» NEW>* REORGANIZE> 
SOURCE» SOURCEGNLYs STRUCTURE» TABLESIZE» TAPE» UPDATE» and 
VERSIONCHECK. - _ 


2e4als . ae 

Initial evaluations of the Priority Memory Management algorithms 
in Mark VII.0 indicate that, wherever possible» OMSIL users 
should have the MPRI option set. With this option set» the 
tength of time which OMSII buffers remain in memory is directly 
dependent upon the frequency with which those buffers are used; 
if items such as index tables are repeatedly accessed» they tend 


to remain in memory. This results in significantly fewer I/O's» 
both reads and writes» being performed. 
224282 

DMS{{ maintains no upper bound for the number of buffers which 
can be present at any one time. Whenever a program tssues a 
DMSYI request» as many buffers as are necessary to complete that 
request will be useds any of these buffers which are not locked 


by the operation are avaitable to be overlayed immediately. 
Buffers which contain. tocked records cannot be overlayed until 
the records are unlocked; if any records within a buffer have 
been updated» that buffer cannot be overtayed until it has been 
written to disk. Also» if a data base uses Audit and Recovery» 
an updated OMSII buffer cannot be written to disk until the audit 
of the last update within that buffer has been written to _ the 
audit trail> this is done to insure that no part of the data 
base on disk is ever more recent than any of the updates 
contained within the physical audit trail. | Because of this» the 
amount of memory used by OMSIT to perform an update function will 
be greater if Audit and Recovery is used. 


Although OMSIL buffers may be candidates to be overlayed (as 
described ahove)» they wilt be overlayed by the new Memory 


Management routines onty if there is insufficient available 
memory to satisfy a request. Because of this» system memory 


duaps witlk tend to indicate that memory is saturated with DMSII 
buffers» regardless of the amount of memory on a_ particular 
system or the nature of the jobs running in the mix. This memory 
saturation is misteadings» since the amount of memory dedicated to 


DMSII buffers will increase or decrease as the memory 
requirements for non-DMSII functions decrease or increasee 
224292 | 


Prior to Mark VII.0» the memory Links describing OMSII buffers 
did not reference the user to whom the buffers had been assigned. 
Because of the new Priority Memory Management » DMSII always 
passes the Limit Register of user programs to the Memory 
Management routines whenever a buffer is assigned to a users, and 
that Limit Register is used by Memory Management to place the 
user's job number in the memory Link for the buffer. Because of 


thise the response to the CU input message may show that the 
amount of memory assigned to a user program is higher under Mark 
VII.0 than it was under VI.-l»s even though no changes have been 
made to the program or to the data base. This apparent increase 
in memory requirements simply reflects a change in the manner in 
which the memory Links are set ups not an actual increase in 
DMSII memory requirements. 


This apparent increase witl occur. whether or not the Priority 
Memory Management algorithm is used. _ . 


224ei19e | ; 

When using the new Priority Memory Management routines». the 
MEMORY PRIORITY assigned to .OMSII buffers will be the 
MEMORY.PRIORITY of the user to whom the buffer is assigned. 


QeSealics ae 

If the user finds it necessary to temporarily change the pack 
assignment for a data base file» this can be done without an 
update DASDL compilation. In addition ta copying the file to the 
new pack» the user must "IL™ the file each time either DMSII or 
RECOVER/DATA.BASE attempts to open the fite. If the pack 
reassignment becomes permanent» the user should perform an update 
DASDL compiles in order to change the pack assignment within the 
data base dictionary. : 


Although it was possible to "IL" data base files in previous 
releases» RECOVER/DATA .BASE would ~~ not detect the pack 
reassignment» and would abort with the message: 


READ.FILE HEADER FAILURE 
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1021-2 Introduction. 


The Mark VII.0O release of NDL inctudes corrections to outstanding 
problemse new NDL compiler statements» and enhanced performance 
when using the MCP Priority Memory Management algorithm. Each of 
the changes made is documented separately in the paragraphs that 
follow. . 


The MCS source files» SOURCE/MCSIT and SQURCE/MCSII» are 
illustrative onty. These files are not to be used to compite a 
running MCS in a normal Data Comm environment. Support is 
neither intended nor imptied. _ 


Temporary documentation describing the NDL/LIBRARY Requests and 
Controls is supplied as a supplement to this release letter tn a 
printer backup file labeled DOCUMENT/NCLIBRARY. | 


Atl references in this section to the NOL Reference Manual refer 
to the B 1700 Systems Network Definition oeguace C(NDL) Reference 
Manual Cform #1073715» dated 6/77). 


10222 Enhancements. 


10 e201 | 7 

The following problems reported in the Mark VI.1 release tetter 
have been fixed (the numbers in parentheses refer to the 
Paragraphs in the Mark VI.1 release letter which originally 
described the problem): 


ae The hexadecimal codes for "SI" and "SQ" are now correct 
CPZ e2) «a : , ; , 


bs. Use of the input message "MAKE STATION nn CNOTJ READY" no 
longer causes a READ OUT-O0F- BOUNDS when using the DYNAMIC 
epauest: set €923.3.- “28 


1022222 2 

The DYNAMIC request now uses STATION TALLYCO) to count 
consecutive timeouts for a stations thus allowing more than eight 
Data Comm lines. 


A0s2s3- | 

The NDL compiler now cross checks POLL statements in the control 
with the AUTOPOLL statement in the LINE section. If the control 
contains a POLL statement but the LINE section does not contain 
the AUTOPOLL statement» an error message is tssued. 
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If the control does not contain a POLL statement but the LINE 
section contains an AUTOPOLL statement» an advisory message is 
issued. This causes unnecessary space to. be altocated for the 
autopoll buffer. oe 


10 s2s4-0 
The blocking factor of the NDL/LIBRARY file has been changed fro 
5 to 9 records per block to save disk space. 


102225- 
The number of disk segments required for the object code file has 
been reduced from 1000 to 750. 


1022-62 ; | 
A QC input message on a Network Controller using RJECTL now 
properly terminates the Network controller. 


AQ e227 | 

The NDL compiler marks the request and control code seqments as 
*“important™ Cfor use with Extended Segment Decay and Priority 
Memory Management) when a Network Controller is compiled. . 


19-2282 - | 3 
Aapersand control Seceuds may now be aabedded in the NDL/LIBRARY 
source file. : . 


10,32 “nown Errors and Restrictions. 


Watele 

If 10L0G is started before a remote file open occcursse the Network 
Controller aborts with a NAME/VALUE STACK OVERFLOW. To use IOLOG 
before the first remote file has been opened» increase the VALUE 
STACK in the Network Controtler by 5000 bits. 


1023-22 

It is not possible to run the HASP and RJE3780 programs 
interchangeably on the same BISYNC tine without first bringing 
the Network Controtter to EGJ. 


AQe5e30 
When an MCS changes a phone number» dashes do not get changed to 
time delay characters of @FFa. : | 


10 23242 | 

Attempting to attach more than one. station on ae Line being 
autopolled and having a phone number terminates the Network 
Controller with a READ OUT-OF “BOUNDS error. 
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1D s3025 

Using an MCS to change “DIAGNOSTIC ON" when no seaonuseic- request 
is compiled into the Network Controtler terminates the Network 
Controller with RUN ERROR 180. 


1023262 : 
When a program opens two or more remote files» the program is 
aborted with “MCS ERROR OPEN DENIED". The remote file is not 


released from the DS-ED job and the station's primary file is not 
returned to the MCS. es 


1023-7 ? : 
After a STATUS request from an MCS» the NIF file is opened and 
stays opens» causing memory to be tied up for the NIF file. 


102328 | 
The maxiaum number of stations that can be defined in a Network 
Controller is 255. 


10.2329 

The “WARNING: ADDRESS NOT DEFINED" message created in the 
AUTODYNCTL control when compiling is a result of NUL characters 
in the poll string. The NDL compiler is not exnecting a poltlt 
string using NUL characters. 

410232102 


When using switched Data Comm tines» the CANDEIOTTY request does 
not answer the second caller on the ame Data Comm line. 


AQs3eh)- — 

When using the SELECTCTD request and a NAK has been received in 
response to a block of text» the request retransmits. the block of 
text the number of times specified by RETRY plus 1. During this 
time no other station is selected or polled. When the retry 


limit reaches zeros the text is discarded without any 
notification to the operator or the MCS Cif present). 
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10.4. Jemporary Documentation. 


10-4212 

The following terminals are now qualified for use with NDL: 
Terminal Direct Asyne Sync 
B9 350 ; x 
B9352 X 
B9 353 x 
DC1LO/TU756 x 
DC141/7TU500 X X 
DC1L41/TU700 . X X 
DCL141/T0850 X X 
Redactor I X 
$1200 X 
™¥C500 xX YX 
™C700 x X 
Tc 3500 x X Xx 
TC4001 X 
TO4201 X 
™O5110 X 
Te5201 X 
™C65210 X 
TD700 X X x 
T0800 X xX x 
T0820 X XxX a 4 
T0830 xX X xX. 
TT102/142 xX X 
TUILO/TU500 x 
B80 X X X 
B800 . Xx X X 
B7 00 X 
B1800/B1700 x X x 


@ 
_ gr 
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10-4022 


The following is a list of terminals and their terminal types: 


Type Terminal | 
0 B9350 (Teletype) 


1 B9353 
2 89352 (Wide) 
3 B9352 (Narrow) 
7 TT102 
10 Redactor I 
13 0€110 
14 DC 140 
17 TU500 
21 TC500 
23 T0700 
25 TC3500 
26 TC 4000 
27 ™€5100 
—— 32. ~—~OTH700 
32. C—=*” 104000 (When using alternate transmission numbers 
. of 0 and 1.) 
| TOBOL 
42 T0802 
43 T0821 
4h TD822 
45 TO831 
46 T0832 
62 B1800/B1700 
63 B6700 
1024232 


The following is a daveraietion of the system status variable 
OUTPUTATTACHED. 


To avoid writing a message back to the top of the station queue 
from which the message was just read (due to a NAK response to a 
SELECT» for example)» the message is Left in the station queue as 
long as possible. This implies that when a tine control 
procedure performs an INITIATE OUTPUT or: any other INITIATE which 
results in outputs the message remains in the queue and the 
request is entered. At this point» OUTPUTATTACHED is false. 


When the request executes any of the following statements the 
message is moved from the station queue to the Network 


Controller's line buffer Cat this points OUTPUTATTACHED is true): 
irene  seneanaemhte se hercaboeeinaremoan acutntinecaraansaammemtnntletetA COURS es / 


INIVIALIZE TALLY (Cn) Where O<n<2 
INITIALIZE TOGCn] Where O<n<7 
TRANSMIT TEXT 
ATTACH» ONTPRUT 
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When the request executes any of the _ following statements» 
OUTPUTATTACHED is reset: 


TERMINATE OUTPUT 
TERMINATE OUTPUT CRETURNA) 
TERMINATE RELEASE STATION 
TERMINATE DISCONNECT 
TERMINATE ECHO - 
TERMINATE ERROR 
TERMINATE INPUT 
DETACH-OU TPG 
QUEVE OUTPUT 

Tem NO INPUT 

AD 244s a 
The following is a description of the LINE CONTROL KEY when the 
value is 5. 


The controt is entered with an output message queued and: 


ae The line is not currently connected» and 


be An ACU adapter is available to connect the line as 
indicated by a strap in the regular adapter» and 
ce A telephone number is provided.. 


19024252 | _ | 
The Declaration Section has been enhanced to allow for global 
defines. The following is a description of the DEFINE syntax: 
Syntax: 

<DEFINE STATEMENT> 23= DEFINE <DEFINE DECLARATION LIST>. 


<DEFINE DECLARATION> :t= <DEFINE DECLARATION> | 
<DEFINE DECLARATION>> 
<DEFINE DECLARATION LIST>. 


<DEFINE DECLARATION> 2:= <DEFINE ID> = #<DEFINITION># 


<DEFINE ID> 2i= <IDENTIFIER> 
<DEFINITION> t2= <TEXT> 
<TEXT> 23= Any sequence of characters except a # 


which is not contained within a character 


stringe 


Semantics: — 


Beginning with the first REQUEST sections any <DEFINE I0> found 
by the compiler is replaced ty its <DEFINITION>. Nested DEFINE 


statements are permitted with no restriction on the number of 
levels. 
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Restrictions: 


ae <DEFINE ID> may not be an NOt reserved words or an 
<IDENTIFIER> which is atready a constant. <DEFINE ID> 
cannot be redefined. | ; 

b. Control (€$) records must not contain defined symbols. 

ce Any controt record detected while processing a OEFINE 
statement is ignored. 

de Comments (2%) are allowed within the <DEFINITION>» but are 
discarded during processing. 

ee A <DEFINE> must not define itself. 

f.- <A <DEFINITION> must not exceed 327 eharaerers: 

ge Parametric defines are not allowed. — 

he Nested defines are expanded without regard to the number of 
levels until the totat size of the expansion and remaining 
source image exceeds approximatety 400 Cheraehers* 

ie Ail Pernt statements are global. 


Exaaples: 


DEFINE CHECKRETRY #IF RETRY GT O THEN 
DO. 
RETRY s= RETRY - 1. 
TERMINATE NOINPUT. 


END.# 


DEFINE REQUESTHRU 


A LINE CCONTRE KEY) = O. &@ 


DEFINE JINX # RETRY = OO. # 

102426 : 
The INPUT MESSAGE column of table 3°73 (Terminate Options) = on 
pages 3°44 and 3°45 of the NDL Reference Manual should be changed 
to "Lost™ for the following TERMINATE options: 


ERROR 
NOINPUT 


OUTPUT 
OUTPUTCRE TURN) 


The OUTPUT MESSAGE column of table 3°3 should be changed to 
"Lost™ for the following TERMINATE options: 


INPUT 
QUTPUT | 
QUTPUTCRETURN) 
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1024272 


A new attribute has been added to the Station Section. 
STATION READY Statement 
Syntax: 

<STATION READY STATEMENT> 2:= READY = <LOGICAL VALUE> 
semantics: | 


If <LOGICAL VALUE> is FALSE» it allows the Network Controller 
to complete the BOJ functions but does not allow it to poll 


this station. © READY defautts to TRUE if this statement is 
omitted from the <STATION DEFINITION>. 
10-4282 


The VARIANT in. the DATA MESSAGE on page 4°6 of the NDL Reference 
Manual should read as follows: 


5 Retain the text on a GOOD-RESULTS-REPLY messSagee 


102429 , : ; 

The JOB“NO in the DATA MESSAGE on page 477 of the NOL Reference 
Manual is replaced by TIME» and is the time at which the Network 
Controller started processing the message. 


10242102 


Two error values have been added to the DATA MESSAGE ERROR field 
on page 4°7 of the NOL Reference Manuals as follows: 


Value Meaning 


12 Exception Occurred 
13 ACU Adapter 
14°15 Reserved 
AD s4 eh leo 


Two additional fields» PROTOCOL-TYPE and SESSION» have been added 
to the OPEN and OPEN“REPLY messages on page 4710 of the NDL 


Reference Manual. These two fields replace the FILLER statement 
between FILE“NAME and STATION-LIST. The following table 
illustrates their positions and field lengths:. 
NC“-MCS MCS=<NC . 

Field Name W R W R PIC 

FILE“NAME * * X€10) 

PROTOCOL~TYPE * * 99 

SESSION * t 9999 

STATION@LIST * * * * (999 )4 
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The semantics for PROTOCOL*TYPE and SESSION are as follows: 


PROTOCOL“TYPE indicates the type of remote file 
intercomaunication desired by the user program opening the 
file. The defined values are: 


00 - Input messages are TYPE O1. 
O01 - Input messages are TYPE 50 or greater. 


SESSION is the remote session number associated with the user 
program performing the open. SESSION is equal to 0000 if there 
is no session association. 


10242122 
The STATUS and STATUS=~ REPLY MCS messages have been expanded. The 
additional fields follow the REMOTE“FILE"HAS"HEADERS field, 
currently defined on page 4°25 of the NOL Reference Manual. The 
new formats of the STATUS and STATUS“REPLY messages are as 
follows: 


MCS“NC NC-MCS 


Field Name W R i R PIC 
STATION@“PHONE - =: * x€20) 
STATION-“VALID | = > * * 9 
STATION“LINE=NO | - * * 99 
STATION“SECONDARYcFILE= NO - = e 999 
FILLER . 9(10) 
LINE*COUNT | - Seo me * 99 
LINE-INFO . ad - * (999 )8 
LINE #99 . 

ACU #9 


The semantics for the STATUS and STATUS*REPLY messages are as 
follows: 


STATION“NUMBER is the tetephone number assignment for the 
station. : . 


STATION“VALIO is a field in the station table which is set to 1 
if the station is valids otherwiser it is set to 0. 


STATION“LINE“NO is the current line assignment for the station. 
STATION“SECONDARY“FILE“NG is the remote file number of the 
station's secondary file. If the remote file number is 000. 
there is no secondary file. 


LINE-COUNT is the number of Lines on which the station is 
defined. . | | 


LINE*INFO is a number of three-character fields describing the 
Line number CLINE) and its associated DIALOUT status CACU). 
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10 e4213. . 
A new CHANGE-TYPE has been added to the CHANGE and CHANGE“REPLY 
messages on page 4728 of the NDL Reference Manuals as follows: 


CHANGE-IYPE Field To Be Changed Eormat 
12 STATION@*PHONE X€20) 


The CHANGE“RESULT should read as fottows: 


CHANGE“RESULT returns a 1 if the CHANGE was correct. | A OQ 
indicates that the LSN field was invalid. A 2 indicates that 
the CHANGE“TYPE was invalid. 


AD e4e14s . . 
-An MCS can now do a Remote File Info operation on any remote . 
file. The Remote File Info has been expanded and an additional 


capability added. 


The format of the REMOTE“FILE-INFO and REMOTE*FILE"INFO-REPLY 
messages is as follows: 


MCS=<NC NC7MCS 


Field Name W R W R PIC 
MESSAGE@TYPE + * * * 99 
JOB-NO a t 9(7) 
TIME we * 9(7) 
REMOTE= FILE- NO #+(x) * * t 999 
OUTPUT“MESSAGES“QUEUED * ~ 94) 
INPUT@“MESSAGES“QUEUED t * 9(4) 
CURRENT“STATION & * 999 
OTHER“RF “REQUEST | * * 9 
OTHER-RF-ERROR * te 9 
GPEN~APPROVER“RF- NO * 99 
FILLER . ° 99 
LSN“LIST * _ (999 )# 
OUTPUT-QUEUED-LIST . & * (999)# 


(x) Mandatory only if OTHER“RFREQUEST is a 1. 
The semantics for the REMOTECFILE“INFO and REMOCTE“FILE~“INFQ*REPLY 
messages are as fotlows: 


MESSAGE“TYPE is ae field which identifies this as a 
REMOTE“FILE*INFO €28) or a REMOTE“FILE"INFO“KEPLY (29). 


JOB“NUMBER is the job number of the job making this request. 


TIME is the time the reply was sent. 
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REMOTE“FILEcNO is the number of the remote file of this program 
if OTHER“RFeREQUEST is set to 0. It is the number of the 
target remote file if OTHER“RF-REQUEST is set to le 


OUTPUT“MESSAGES=QUEVED represents the total number of messages 
queued for alt stations attached to the remote file. 


CURRENT=STATIONS represents the number of stations attached to 
the remote file. 


OTHER“RF-REQUEST is 0 if the request is for the writing MCS*s 
file. It is a 1 if REMOTE"FILE°NO contains the fite number 
about which information is requested. 


OTHER“RFTERROR is 121 in the REMOTETFILE-INFO"REPLY message if 
the requestor set OTHER-RF REQUEST to 1 and the REMOTE"FILE-NO 
supplied was nonexistent. 


OPENTAPPROVER“RF“NO is the remote file number of the MCS which 
approved the requestor‘*s open. 


LSN-LIST has an entry by LSN for every current station. . 


OUTPUT-QUEUED*-LIST has the number of output messages queued for 


each of the current stations. The total should agree with 
OQUTPUT“MESSAGES-QUEUED. 
1024215. 


The following is a description of USER MESSAGES. 


An executing MCS can interface with a user remote file without 
headers through the record format shown betow: 


MCS*USER USER-MCS 


Field Name W R WwW R PIC 
MESSAGE.TYPE + * * * 99 

FILLER * - -« 9 

LSN a tt * 999 
TEXT-SIZE t x * 9999 

TEXT * ak ot * XCTEXT.SIZE) 


The semantics of the fields of the USER“DEFINED message record 
are as follows: 


MESSAGE.TYPE is established by the user program and must be a 
number greater than 49 and less than 100. 


LSN is the Logical Station Number to which the data betongs. 
TEXT.«SIZE is the number of characters in the text field. 


TEXT is the character string which is being passed. 
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40242162 

A new $ control options LIBINFO» has been added to the NOL 
compiler. When the LIBINFO control option is included in an NOL 
compiles a List of all requests and controls in the NDL/LIBRARY 
file is printed on a separate page at the end of the compile 
listing. 


WDe4elZa | . 
The description of the $ LIBRARY controt option should read as 
fottlows: . 


LIBRARY <identifier> The NDL source code specified by the 
<identifier> is retrieved from the 
NDL/LIBRARY file and inserted in the 
user*s program fottowing the &% LIBRARY 
option. . 


1024218 
The maximum allowable Network Information Fite (NIF) table sizes 
have been increased from 16K bytes to 40K bytes. 


10240192 


The word DEFINE is now a peeceved word. 


10242202 
The DYNAMIC requests. and control have several advantages over the 
AUTOPOLL requests and control» as follows: 


ae Stations that are not on fiWe (poreted off) are deleted 
from the autopoll string. | 

be If output cannot be sent because the terminal is in 
TRANSMIT or LOCAL» all terminals are autopcttled once before 
the terminal is selected again. | , 

ce When an output message is sents» a FAST“SELECT is used the 
first time. If the FAST°SELECT fails» a normat SELECT is 
done to conserve Line time. 

d- The controt is designed to handle groups and switched 
lines. _ 

e. If a terminal has output queued for it and the terminal is 
powered off or taken off line» the control stops trying to 
send output until the control can potl the terminal again. 


Reconfiguration: 


The control does an automatic reconfiguration every three 
minutes. The 3 minute figure should be increased for large 
networks or the controt may stay itn reconfiguration mode 
continously. Reconfiguration is accomplished by putting 
previously offeline terminals on the end of the poll string so as 
not to interfere with active terminals. 
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To change the amount of time before an automatic reconfiguration 
occurs» two source statements must be changed in the AUTODYNCTL. 
The first statement is at sequence number 04505000 and is as 
follows: 
IF LINECQUEUED) OR LINECTALLY(C3]) = 6 THENZ 
The constant 6 must be changed using the following formula: 
NUMBER OF MINUTES BEFORE RECONFIGURATION * 2 


The second statement is at sequence number 04535000 and is = as 
follows: 


IF TIME = TIMECTALLY) GT 1800 THENZ 
The constant 1800 must be changed using the following formuta: 
NUMBER OF MINUTES BEFORE RECONFIGURATION * 600 | 
Once a terminal is actives the terminal is not removed from the 
autopoll string unless the terminal times out 3 consecutive 


times. 


The length of the autopollt buffer: declared in the Line Section 
must be 5 times the number of stations on the line plus 5. 


10242212 
When using the AUDIT statement in NDL to audit messages for 
recovery» the VALUE stack size must be increased. First» 


multiply the Largest record to be audited by 23 then convert to 
bits by aultiplying by 8. Add this figure to the VALUE stack 
size given by the NDL compiler for the Network Ccntrotlter. 


10242222 
To decrease the everkeed of the IOLOG on the Network Controller» 


modify the Network Controller as follows: 


MODIFY <network controller name> | 
FILE IOLOG BUFFERS=2 RECORDS -BLOCK=<integer>; 


where <integer> is the largest message received or transmitted, 

divided by 131, plus 1. This modification has no effect on the 
memory requirements of the Network Controtter unless data comm 
activity is being audited Cthat is» the I[O0L0G option is set). 


10242232 
MAX TALLY must be set in the Declaration Section to the number of 
tines plus 1 when using the DYNAMIC requests and control. 


10 s42240 

When retries becomes 0 and just before the station is temporarily 
deleted from the autopott list in CANDEPOLTD+ the station is 
single polled once to check that it is timing out consistently 
and not just intermittently. If £E0T or SOH is received, the 
station is assumed active and is not deleted from the. autopoll 
list? otherwiser the station is removed from the autopoll list. 


10 24s255 

If progran Suitch 9 is set to a value other than zero in the 
Network Controtler >» the file STATION.SAVE remains open. This 
file is used for a number of functions» especially when running 
with an MCS» and must be opened and closed each time it is 
referenced. In large networks» where ATTACH/DETACH» STATUS» and 
other functions are frequently requested» it may be advantageous 
to specify that the STATION.SAVE file remain open constantly in 
order to remove the MCP overhead of many OPEN and CLOSE requests. 
The memory required by the STATION.SAVE file when it is open is 
approximately 600. bytes. 


10242262 
A participating MCS that approved a remote file open can detach a 
station from that remote file. 


10s4s2Z0 | 
With the Mark VIII.0 release NDL» an MCS witl no longer be able 
to change STATION CENABLED). 
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11. CANDE 


Jl-1- Introduction. 


Included as part of the Mark VII.0 software is the B 1800/B 1700 
Command and Edit (CANDE) tanguage. 8 1800/8 1700 CANDE provides 
generalized file preparation and updating capabilities in an 
interactives terminalroriented environment. 


8 1800/8 1700 CANDE is a Message Control System (MCS) that runs 


in conjunction with the 6 1800/8 1700 NDL system. The 
NOL*generated Network Controller performs alt the functions 
related to data communications» while CANDE performs’ file 


updating and textr-editing functions. 


The 8 1700 CANDE User's Manual Cform #1090586» dated 68-76) is 
available through normat distribution channels.- New features not 


yet included in the manual are described in the paragraphs that 
follow. 


d1le22 Enhancements. 


AisZeis . 

The following problems reported in the MARK VI.1 release letter 
have been fixed (the numbers in parentheses refer to the 
paragraphs in the Mark VI.1 release letter which originatly 
described the problem): . “4 . 


ae CANDE no Longer reports a sequence error when trying to 
List an empty file (21.3.1). 


be CANDE does not reject a filename that begins with an 
integer or contains a hyphen if the filename is enclosed in 


quotes (2123.2 and 21.3.3). 


ee ert tn arent 


Ce CANDE will disptay a message at log on time that a default 
pack is not on line. At this time the MCP wilt set the 
override bit “*ON" for that usercode. When the pack is 
brought on line the user can reset the override bit with 
the MCP RV input message (21.3.4). 


d.- The ability to create a untque filename has been added to 
the WRITE command (21.3.6). For example: | 


WRITE <filename> AS <filename> 
e. After saving a "DATA" file» CANDE now allows the user to 


get another fiie or List a backup file without resequencing 
or removing the work file (21.3.7). 
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f- A new option» “OVERRIDE™» has been added to the “RESEQ" 


command to properly resequence a file with blank sequence 
numbers (21.3.8). 


de The "REPLACE LIT / / //* command no Longer causes CANDE to 
loop (21.3211). 


he CANDE displays the proper error message when the "TITLE" 
command is entered in the foram of <name-1>/<name-2> 
(21-3212). 


is CANDE uses the correct packrid when the "RUN" command is 
used from a user pack (21.3.13). 


Lisie2s 
When listing Apinter backup files with CANDE> the second line is 
not dispdhayed if it contains att blanks. 


Alelese 
Starting with the Mark VII.0 release of CANDE» a GET or MAKE on a 
file with a type of SDL assumes the underscore as the identifier 
break character. UPL files continue to use the period as the 
identifier break character. 


1122-4. . | 

CANDE automatically logs a terminat off when the retry count in 
the Network Controlter has been exceeded. The Network 
Controllers» beginning with Mark ViI.0» resets the timeout counter 
each time a valid reply is received on a tinee This witt help to 
increase the time before CANDE automatically logs a terminal off. 
The time can also be increased by setting the RETRY vatue in the 
Network Controttler to a targer number. 


dlseisis 


The maximun message size Sitoved with the n255" command has been 
increased to 240 characters. 


1122-62 | 
The maximum number of terminals that can sign on to CANDE at the 
same time has been increased to 64. 


dleeels 
CANDE now accepts 10°character filenames» with the following 
exceptions. 


ae The familyename is still limited to seven characters when 
CANDE is executed with a usercode. 


be The COMPILE» EXECUTE» RUN» and WRITE verbs may only allow 
up to nine characters when it ts necessary for them to 
concatenate the filename with an additionat character’ to 
form a new identifier. | 
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412228. | | 
Keywords may now be entered in Lower case*? however» CANDE no 


longer accepts a usercode/password in lowercvcase tetters during 
the log-on operation. 


| 112222 ; : : 
MCP responses to *?" commands have Been increased to a maximum of 
250 characters. 


122219 | 
A new command» AUDIT» thas been added to CANDE to attow the 
auditing function to be dynamically started or stopped. Refer to 
paragraph 11.-4.13 for complete documentation. 


Als3e Known Errors and Restrictions. 


Nene en 
Wledale | 5 eae 
—| A margin nuaber is ignored on a single ("SEQ” entry. 


Lisic2s LLt9 | 

If CANDE is executed under a usercode and the system fails fo 
1 some reasons CANDE- must be remexecuted unader-the same usercode® 
order to recover the files that were. pene used when the system 
failed. : ; 

Fe Bee 


d123232 


When 80 or more carriage return char acters are ertered from a TTY 
devices CANDE will terminate with an "INVALID SUBSTRING” error. 


siete fo | 
CANDE will be DS-ed Yf disk errors are encountered while saving a 


file. 4 )F- a) PO Le-4d 


ey 


5 


1124. reanorary Documentation. 
N\ Qddedele) Usercodes and File Security 


If “executed under a privileged usercode/password»s CANDE useS’ the 
File Security mechanism implemented in the MCP. As aeresult» 
users must be aware of the following items: 


a» Usercodes are delimited by parentheses and» ‘in the case of 
CANDE» are Limited to seven characters in length. Log=on 


is accoaplished by entering the. usercode without 
parentheses. ; 


be Usercodes and passwords may have a default pack associated 
with them. If a default pack has been defined» CANDE reads 
and writes all files on this pack. The default pack may be 
overridden by exptlicitty specifying a pack-id with the "ON" 
attribute. | 


i Mwvot! 


Av 


Gt = a if 
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ce ALL files saved through CANDE are saved as “PUBLIC” of 
"PRIVATE™» according to the default protection specified in 
the CSYSTEM)/USERCODE file. PRIVATE files can be accessed 
only by a program running under the same usercode as that 
of the file or. by running with a "orivileged” 
usercode/password.e -The security of a file can be changed 
by using the MCP MH input message. 


de CANDE has a facility for two-way communication with the 


MCP. Messages may be zipped to the MCP from the remote 
terminat. Responses to these messages are directed back to 
CANDE» which then routes them to the requesting terminal. 


For exaaple:. 
2WY. Returns the status of only that userts job(s). 
?7TO ReLupAs the current time and date. 
2MX Returns the mix for only that user's job(s). 
240 Modifies only aes belonging to that user. 


PRE isusercoder yc Titenaaes Removes the file only if the 
usercode in the filename is 
the same as the usercode 
under which the user is 
runninge 


@e CANDE can List» on the terminals printer backup files which 
have been created by jobs executed through CANDE. Backup 
files are locked in the disk directory with a name of the 


form "(<usercode>)/a#<integer>". | The command "LIST 
#<integer>" displays the backup file on the screen’ for 
review. {If CANDE is not executed under a usercodes' the 


facilities of backup file naminge file security» and MCP 
coarmunication are not provided. 


CANDE Execution 


To bring up the CANDE system under File Security» a PUBLIC» 
privileged usercode/password pair that does not have ae default 
pack associated should be setected from the (SYSTEM) /USERCODE 
file. This enables CANDE"s recovery» tank» and workfite to be 


placed on system disk for easier maintenance. To execute CANDE> 
enters 


USER=<usercode>/<password> EXECUTE CANDE 


The MCP automaticatly executes the Network Controller» if one is 
present in the "°C" entry of the NAME TABLE. The Network 
Controller is placed in the NAME TABLE by using the MCP CM input 
messagee ; 


PC Se 


hn, 
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To request CANDE to Zipexecute a Network Controller named 


‘ CANDE/HANDLER Cif a Network Controller is not identified in the 


eee 


Disk Pack Defaults 


NAME TABLE)» CANDE must be executed with switch 0 set to 1 
CSWO=1)> as in the following example: . ; 


USER=<usercode>/<password> EXECUTE CANDE SWO0=1 


If the Network Controller was executed by the MCP from the °"C*" 


entry in the NAME TABLE» andthe tast remote file "CLOSE" has 


been processed» the MCP will queue a "QC" for the Network 
Cantrotler after three “"N.SECOND™ intervals Cif no intervening 
remote file opens occur). 


AQTE 
CANDE may be executed without a usercode. If this is 
done » CANDE does not provide file security or MCP 
communication. 7 


ii ee 


ennai 


Since the MCP forces files to the default pack associated with 


the usercode/password» syntax has been implemented to access 
files on system disk if a default pack was specified in the 
CSYSTEM)/USERCODE file. The following table applies to att 
commands allowing filenames» except for "SAVE". 

Entec Pack=id Family-nage File-ig 

A <default> CuCc) A 

A/B . A B 

A/B ON C Cc . A B 

CUC)/A €<default> (UC) A. 

C€UC)/A ON C C (UC) A 

eC(UCISA ~ €UC) A 

“< | aes 


A fileridentifier may not exceed 10 characters in Length» 


including the "*"» "("*». and ")" characters. “*(ABCDEFGH)"™>» tor 
examples is invalid. 


An asterisk entered preceding a filename denotes that the file is 


on system disk» and CANDE looks for a literal name following the 
asterisk. To access another user's file» that file must be 
changed from “PRIVATE” to “PUBLIC” by the owner or be accessed by 
a privileged usercode. When saving a file» it cannot be saved 
under a different usercode.. Thus» the command “SAVE AS 
*(<usercode>)/A™" is itlegal; "SAVE AS *A™ wiht save the file as 
“(<usercode>)/A" on system disk. A command such as “SAVE AS A*® 
wilt save the file on disk as “<default pack>/(<usercode>)/A". 
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Horkfile 


. 
CANDE can be directed to read any file to which the user is 
allowed access. However» changes may be made only to one file>» 
the "workfile”. The user gets a new workfile by doing a "MAKE", 
or may recall an existing workfile by. doing a "GET". Additions 
and corrections may be performed on the workfile by single-line 
entries or by using the editing commands. . 


A CANDE workfile consists of two parts. The “tank” (which is 
invisible to the user) is where additions and edited lines are 
placed until an "UPDATE" takes place» The tank contains a 
maximum of 32 entries. If an explicit "UPDATE" has not been 
issued by the time the tank 1s full» an automatic update is done 
to merge the contents of the tank with the workfile. An update 
incorporates alt additions and corrections to the workfile-, 
creating a new copy of the workfile and an empty tank. An update 
does not make the workfile a permanent file on disk~ A "SAVE" is 
required to make the workfile a permanent file and to discard the 
original file. <A “SAVE" creates a new file on disk with an empty 
tank and workfile. 7 


The second part of the workfile consists of ntl blocks within 
CANDE*'S master workfile (named "CANDE/WORKFILE™). The n is the 
number of contiguous blocks (each 64 records long) needed to 
contain atl currentty changed records» including deletes. Note 
that CANDE never writes to the original source file. The file is 
only changed at “SAVE™ time. 


Record Modification 


If a file is present (Ca “GET"» “MAKE"» or "RECOVER® has been 
processed)» the user is assumed to be in a state of editing the 


file. Any input consisting only of records having vatid sequence 
nuabers with no sequence errors is treated as records to be 


entered into the file. After the input is processed» a “NEXT” is 


performed automatically» meaning that the next "PAGE" is 
displayed» beginning with the record that follows the last one 
entered. 


"PAGE"» "LIST™ Cexcept from an external file)» “"BACK"» "SAME*>» 
“NEXT™» "=", and "+" explicitly request a page to be displayed. 
For CRT devices» records may then be edited and the page Cor 
partial page) transmitted back. For non-CRT devices» the records 
must be retyped- 


For recovery purposes» CANDE does not clear the CRT screen at 
log-on time. The user may recover the file and transmit to the 
System any records tleft on the screen at the time of the failure. 


The buffer used by the “PAGE” systems located in dynamic memory 
in Mark VI-i»e is now part of static memory Cin the VALUE STACK). 
This buffer is used to “rolt in™ the last output in order to 
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compare the current input against it. This comparison allows 
CANDE to add to the tank only those records which have changed» 
and is required to prevent writing unnecessary records to a file 
when a “SAVE: PATCH” command is entered. It also makes input 
processing more efficient. | 


The comparison occurs on a record=by“record basis as long as the 


sequence numbers match. If a sequence number is encountered’ in 
the input which does not exist in the last output copys then 
comparison ceases and the record is added. Processing continues 


in this fashion until either the sequence number of an input 
record is greater than or equal to that of the last output record 
Cat which time comparison ceases)» or until all input records 
have been processed. This prevents unnecessary error reports or 
"ADVISGRIES™. Also» synchronization of record comparison is 
maintained and unchanged records are not added to the tank. If 
the page of input returned to CANDE is missing any records 
initially displayed (that is» the user has performed a “LINE 
DELETE® on the terminal)>, the missing records are not 
automatically deleted from the workfile. 


Line Deletion 


Single lines may be deleted through use of the "VOID" command. A 
"Vv" must be the first character of the Line and the line must 
contain a valid sequence number. Any number of blanks» or none 
at all» may separate the command and the sequence number. 


A delete record wilt be queued for later processing and input 
processing will continue. If the sequence number is in errors 
the record will be treated as a sequence error. 


NOTE 
This form of deletion may be time-consuming» because 
each deletion request will cause an update. No 
optimization of successive, contiguous "VOIDS" is 
attempted. 


File Positioning 


CANDE allows the user to move backward and forward throughout the 
files once *PAGE* or "LIST*® is invoked. “PAGE™ or "LIST" in any 
form causes the file "position" pointers (Cfor "BACK"> "SAME * >» 
WNEXT™» "=", or "#") to be set to the requested position. For 
CRY devices» after displaying a page» “NEXT” is written at the 
home position teaving the cursor immediately after it. Thus» 
transmission without moving the cursor will effect "NEXT" 
automatically. <Any other string transmitted in the first line is 
treated as a command input. If transmission includes more’ than 
the first lines, it is assumed to be input records. The first 
line is ignored and the input is processed. 
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File positioning is controtted through the following commands: 


BACK <n> Display current ~<n>th page. 

SAME Display current page ogi 

NEXT <n> Display current $<nsth page. 

“<n> Display page at current ~<n>th record. 
#<n> | Display page at current +<n>th record. 


After a "GET%» “MAKE™» or "RECOVER™» the above commands are 
operative. If <n> is not specified» a value of one (1) is 
assumede . , 


"e<n>" and "="<n>" shift exactly <n> records in the direction 
requested. “BACK <n>" and *NEXT <n>* shift approximately <n> 
pages in the direction requested- In this way» “BACK™ and "NEXT" 
may be used to position the file to approximately the desired 
area quickly without reading through each record on the way from 
the current position to the requested one. Once in the 
approximate area» the position may be adjusted accurately by 
using “t<n>"* and “-<n>*. The range of records shifted is: 


1 <= r <= 131071 


where r=n for "#" and =", and r=n*«pagesize for "BACK" and 
"NEXT". 


Recovery 


Recovery of a user's workfile is necessary when CANDE is executed 
after an abnormal termination or when the users terminal incurs 


consecutive timeouts. The recovery procedure involves creation 
of the recovery file and communication of this fact to the user 
during logon. The recovery | file | is named 


"<usercode>/recovery<ab>". <ab> is a unique 2~character sequence 
created as follows: 7 


(<usercode index>/36)th character of atom (see below) 
(<usercode index> mod 36)th character of atom 


iol 


a 
b 
where atom = ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789. 


For examples the character "A" is the Oth character of atom» and 
the character "9" is the 35th character of atom. 


This scheme produces a unique recovery file for each 
usercode/password pair. To avoid toss of the file upon recoverys 
users should not intentionally create files named in this manner. 
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After logon each user who was on the system when it aborted has 
the option of recovering the workfile. The user must enter 
"RECOVER" to get the previous workfile. If the user does not 
wish to recovers then another session may be started. When a 
system failure occurs» it is. possible. to lose up to four records 
in the tank file. 


Displays and Errors 


"TERMINAL PAGE" sets the page size as requested. See paragraph 
11.4.10 for the default page sizes depending on terminal type. 


All displays to a device having a page size greater than one 
begin on the second line of the screen and end with the column 
indicator on the tast line. 


Any Line whose first token is a valid CANDE command is taken as a 
‘new coamand and executed after the records to that point have 
been processed. : 


Alt. numerics in sequence fields indicate to CANDE that after 
input is processed» the next page should be displayed. 


Sequence errors are defined as either: 
ae Numeric but out of sequences or 


be. Beginning with a non-numeric character which is not a valid 
CANDE verb or a “V" (refer to Line Deletion). 


The action taken in such a case is to teave the screen alone and 
notify the user on the top tine of the screen. 


Inserts are de fined as numbers that are in sequence but which 


were not put on the screen by CANDE. The action taken is to add 
the record(s) to the tank and to discontinue comparison against 
the copy until the next copy sequence number is encountered. 


For devices whose page size is ones the following operating 
characteristics are vatid: 


ae The “BREAK” key (teletype only) clears the output queue and 
terminates the operation. 


b. When "SEQ" displays an existing records CANDE sends a CR 
(Carriage Return)» LF (Line feed)» and rettypes” the 
sequence numbers Leaving the carriage immediately after the 
number to allow the line to be changed and re~entered. If 
only an. ETX or CR is returned» the record is not changed 
and the command continues. If it was not an existing 
record Conly a new sequence number)» then returning only an 
ETX or CR terminates the command. 


L4l 


Ce "PAGE" treats displays as noted above for "SEQ". 
d. “LIST™ is continuouss rather than paged. 
@-o “BACK » "“SAME%> "NEXT%>» "-"» and "+" are operative. 


f- “V" is not operative. 


CRI-tyne Devices. 


Paged output to a CRI-type device is preceded by a “HOME and 
CLEAR" character and has the CR character appended after the 
rightmost non-blank character in each Line in order to decrease 
transmission time. If the Line is blank» it consists of a CR 
character only. Single-line output to a 10820/830 series device 
has the LC CCLEAR to END of LINE) character appended to it» in 
order to clear the remainder of the line. 


acroltling 


The NOL CANDE tibrary - requests (CCANDEPOLTD> CANDEFSLTD» and 
CANDESELTD) contain a scrolling capability available to users 
running CANDE and to those running an application program under 
CANDE.} Scrotling is disabled by default. Enter *2?+" to enable 
ReCOREE NG and *?-" to disable scrolling. 


ALt output Cexcept full page output produced ‘Oy LIST™» "PAGE>» 
and "SEQ") is written one line at a time at the bottom of the 
screen after shifting the screen up one line (Cthe top tine is 
deleted). <Any input except paged input is scrolled to the bottom 
of the screen. age 


Ale4egs PAGE 


The "PAGE" command displays full screens of information at the 
terainal for editingre and accepts full screens of input from the 
terminal. The operation continues until the command parameters 
have been satisfied or any command is entered on the top Line of 
the terminal. . 


{ 
ayntax 
PAGE late tate i ateketatatetatetetetatetetatetatettatetetateltetetetetatatettetatetatet a | 
{7ce3-- NEXT STAN TE RHO Oem y | 
i = . 1 
toreere> (41) <delim><text><delim> ---->l 
I { i 
{ [-=> (1) ONLY semanas amewamoanne> | 
i - I 
i f==> €1) LITERAL eee teew nmr enenann) | 
t ! = i 
] j-"> (1) 2 <column range> -*<<---=>{ 
1 . | 
porrernrnr> C1) <sequence range> ce "77%" "" >I 
<delim><text><delim> Scan each record within the 
range for the delimited text. 
page starting with record in which text 
is found. . ss 
<sequence range> Begin at Si» terminate after S2. 
atone impties S2 = end. 
BOF-E OF. 
ONLY Display only records with target text. 
LITERAL As in REPLACE» FIND. | 
a As in REPLACE» FIND. 
NEXT Resume action requested 
"PAGE" command. 
Example: 
Assume that the page size=2 and the file contains’ the 
records: 
100 ABCDEF 
200 GHI JKK 
300 LW¥NOPQ 
400 £RSTUVW 
500 XYZABCD 
600 EFGHI JKK 
700 LMNOPQ 
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sequence 
Display 


$1 


previous 


following 
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Comgandgd Response 
PAGE ONLY /KK/ LITERAL Display 200» 600» terminate. 
PAGE 100 . Display record 100» terminate. 
For CRY devices» "NEXT" is written at the home position. For 


text searching» “NEXT” means begin searching with the next record 
after the one first displayed Cif "ONLY" is not specified) or the 
last one displayed Cif "ONLY" is specified). 


NOTE 


The meaning of a single sequence number in a sequence 
range specification now differs between "LIST" and 
"PAGE". "LIST <seq>"* displays the singte record at 
sequence number <seq>. “PAGE <seq>" displays a page of 
records» the first of which is the record at sequence 
number <seq>. 


die4e3se GET 


The "GET" command has been changed to default to the "NO CHECK" 
option and has added the asterisk ("*#") prior to the filename. 
When *** is specified» only the titerat name following the "*" is 
Looked for in the disk directory. This allows a "GET" on a 
Single-name file. If the "“«*" js used in front of a two-name 
file» it indicates the file is on the system disk. 


4124242 \LIST and SAVE _ 


The "LIST" and *SAVE”" commands have added the. asterisk *** to 
specify that the file is on system disk» and that the pack-id in 
the usercode file does not apply. 


11242352 WHAT 


The response to the "WHAT" command has added the _  fotlowing 
information: 


Source file size 
Tank & workfile size 
Source file pack-id 
Patch file~id 


err Filename >) < 


ad 


omen trterarrrs al 


A filename is “used to identify a file in the 8 1800/8 1700 
system. When a file is created through CANDE» the user supplies 
the file-id Can alphanumeric identifier of nine or fewer 
characters with the first character being non-numeric) and CANDE 
adds the usercode to form the complete filename (for example» 
<usercode>/file-id). 


, 
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The user may access any file under his usercade by = simply 
specifying the <file-id>. The user may also access PUBLIC files 
belonging to another user in a readsonty mode» by specifying the 
<usercode>/<file-id> of the file being requested. Users may also 
access files on user packs or cartridges by specifying “ON 
<pack-id>" after the <file-id> or <usercode>/<file-id>. 


2yntax: 


iol a cada S's Sb eo liao a ew el ea eh filecrid See ae nie a al ee ee en 


, - sf ow | 1 
i---> usercode/ --">! fe => ON pack-id --->! 


Ade4e7e FIND 


The "FIND". command searches a file for appearances of specific 
text. Qutput indicating the result of the search may be directed 
to the terminate. The output of a “FIND"™ is prompt-driven. This 
means that the command fills a screen to its page sizes the user 
must then transmit a character to get the next page of output. A 
"2BRK" breaks the output as soon as possible. 


Syntax: 


FIND Sanwa SRD aus aene w > <delim><text><delim> maeenwy 
= mm J crm e wwe mawaraenamaee | 
fm-> C1) <count> <->] 
i i 
inm=> (1) LITERAL =>! 


{ <eSee ee ese Ses eene eee = aseanaaw am Srna vee eee te ae ee eve ee 
{*=> C1) <filename> aa nanene wwe = FREMONT REA SAA en wes ey. | 
i : | | ler=> <type> =>!) - ! 
i oo . " 
le=> 01) “<sequence Cange>: SSeS rerss "= ss="—= ie ania ea 
1 i 
Pee CL) a SCOLUBN fange> Sores es Tener See aes ened 


rf 
t ee —_— / 


ten-> (1) 


>> (1) ETEXT wooo anne e ween ennn nn en enn=>| 


saan wo { 
1 t 
“> C1) SFILE ee eeerererns> <filename> -->] 


nemantics: 


Onty one target may be sought with a “FIND*. The delimiters 
surrounding the target <text> may be any delimiter. The <text> 
may contain any characters except the delimiter. The text fietd 


may not be empty. The text field is treated as a token string 
unless "LITERAL" is specified. 
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The search is successful whenever the string of characters in the 
<text> is found in a line of the file. 


If the integer <count> appears»s — the search for the associated 
<text> is terminated after it has been found the specified number 
of times in the file. . os 


If aé<filename> is not specified» the workfile is searched by 


default. | Specification of a <filename> causes searching of the 
designated file» which may be any file the user is altowed to 
read. | 


A <type> may be specified to give the tocation of sequence 
numbers in the records to be searched. If no <type> is specified 
and the user does not have a workfile» a type of "SEQ" is 
assumed. Otherwises, the file type wilt default to that of the 
workfite. 


If a sequence range is specified» only records falting within. 
that range are searched. | | 


A column range» if provided» indicates that only a specified part 
of each record is to be examined. | Note that a <column range> 
cannot fall within ‘the sequence- number field Cfor exampler 
coluans 73°80 for SDL files). 


The defaults for <sequence range> and <column range> are the 
entire file and the entire record» respectively. 


The option “TEXT> if specified» displays the entire line 
containing the <text> on the terminal. Otherwise» only the 
sequence numbers of those records containing the string are 
displayed. 


The option "FILE <filename>" directs output from the "FIND" to a 
disk file tlabeled "(<usercode>)/<filename>®*. The user may not 
specify a usercode with this options his own usercode ts used as 
the famity-name. If the option *:FILE «*<filename>™ ts used» the 
file is forced to the system disk and is not allcwed to go to the 
default pack associated with the usercode. 


Examples: a 
FIND / fileid / 100-900 :TEXT 


Search the workfile for the occurrence of ™ fileid * within the 
records numbered 100°900 and output any Lines found. 


FIND 10 / STUFF / 


Find the first ten occurrences of % STUFF " within the workfile 
and output the sequence number of the records found. 


ou f 


af after ie ( vir 


ae) 
pCQUL’ \ 
Bt ear Oa TEs puRce sows 1 | 
: er art ae tO TA@MOVL Ci CAy 
7 ‘ as : sca vecoucy 4 oer ‘net 
i eae . ane c t 
1124-82 RECOVER . : uy ee yw 

yoCcecud\ 


The "RECOVER" command has added the “:PURGE™ option. This 


simplifies the removat of recovery files teft on disk. 
A124292- SEQ 
The "SEQ" command invokes automatic sequence moder causing CANDE 
to provide the sequence number for each new line. With the 
exception of "a" (margin) and "?" (control command)» no commands 
are recognized in automatic sequence mode... 
ayntax: 
SEQe="7°" mame ee on Speer ae yer ee aera meer ee DAREN AHR EMAKB EBON BOO ae Bae w@ >] 
- { | { 1 
— feerter> <base> "47> ] pewernwm=> t<cinc> z9=>] ae 
i 1 
[see ee> NEXT “ese =o eee 


i ! STP a 


la-m--> END -onem-o >I 


NEXT Begin sequence numbers with fast output +<inc> from 
previous SEQ.) 


END Begin sequence numbers with tast record sequence. 
Semantics: 


An initial value is assigned as the sequence number of the next 
line to be entereds the value is incremented for each subsequent 
line. Values are specified by an integer <base> and <inc> or by 
defaulting to values of 100 for <base> and <inc>. If "NEXT" is 
specified» sequence numbering begins where the last sequence 
numbers for that user» was terminated. 


Sequence mode may be terminated by transmitting back onty the 
sequence number. 


"SEQ" displays existing records as well as the newly-created 
sequence numbers. Display begins with the tast record from the 
previous input page if the page size is greater than one. 
"BACK" » *"SAME",» "NEXT", "=", and "+" terminate the “SEQ" mode and 
display the requested pagee For CRT devices» returning only the 
sequence number of the first record terminates the "SEQ" command. 
Blank records are added to the file. Margin is not applied. 


147 


Example: 
S 10+10 


Enter automatic sequence mode using an initiat and increment 
value of 10. 


AlL24e190- TERMINAL 


The “"TERMINAL" command allows the user to specify or query the 
number of Lines per page or screen for the terminal» or to modify 
the output mode of the terminal. 


2yntax: 
eenm-=> TERMINAL ----- we et wee mew em ene meme mm enmseana>| 
1 -c08 P77> PAGE trot tte eter e steerer en=>] 
2? =>1 ! cere | a | 
| im-> <integer> “~>] t 
t ) 
1-=> CONTINUOUS ese ce enw enna nn =>] 
i coe i 
1 t 
b--> WALT sccm eeweseecnn- women > | 
Semantics: 


"PAGE" specifies the number of lines per page or per screens as 
the integer page length. Default page sizes are as follows: 


Device  Jerminal Type Page Size 
89350 Teletype 0 1 
TC Series 21223924 025 226 927 1 
™700 32 2 
TOB8OL 4t 10 
TD8O2 42 22 
TO821 43 10 
T0822 4h 22 
TD831 45 10 
T0832 46 | 22 


The default page sizes are atso the maximum possible values. 


If no parameters are specified» the current page size and current 
output mode are displayed. If a page length is not specified» 
the current page size is displayed. 


"CONTINUOUS" causes the terminat to be teft in £4“RECEIVE®? 
unconditionally after each outputs if "scroll" is enabled. 
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"WAIT" is the default output mode and causes the terminal to 
switch to "LOCAL" after most outputs. | 


NOTE 


TD830 series terminats are treated as TD820 terminats»e 
except for FAST*SELECT and the “stop. highlight" 
character. T0830 terminals on twotwire direct~connect 
Lines should have the system adapter strapped for a 
L15-millisecond WRITE delay. . 


LisSell1. WRITE 


The "WRITE" command prints or punches the contents of the 
workfilte or some other file. Cptions are available for selecting 
specific Lines or columns. The output of the "WRITE" command is 
forced to printer or punch backup. 


Syntax: | 
WRI TE toe ce cn wn nn ncn ce ee mn ww wen een eee nee eee eee een en nn n> | 
-—/= ; | Koon ew we eee wee cece ses comme ence enna oonocoe= mo oe am wo { 
i "> *« ~>] i--> <type> >! ! 
i -- | | 
7 7 a, 
(.gee> CL)I“-> sCOPIES <integer 1 to 63> secon een werner =>| 
| ene ann ae a ‘ I 
i 1 
i . I 
[==> C1) <column range> ow meme meme nnn nem ener erannnn>| 
Po-> CL) TO seme mne> PRINTER coerce ee ee nen n nnn nn---->I 
[----> CARDS ===>! 
[sees 
[o-s--> PRT ---- 1 
Semantics: 
By default» the contents of the workfile are printed. If a 
<filename> is specified and the user has access rights Cor if the 
file is PUBLIC)» it is used. A <sequence range> and a <column 
range> may be specified; otherwise» the whole file and the 


entire line are printed or punched. 
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The COPIES option is honored by SYSTEM/BACKUP unless overridden 
by the operator. If this option is not specified» the default 
number of copies produced is 1. 


This command should be used in conjunction with the AUTOPRINT 
mechanism in the MCP. If AUTOPRINT is actives, "WRITE" generates 
a backup fite that can be printed or punched automatically. 


Examoles: 
WRITE | Writes to a printer backup” file atl 
records in the user's current workfile. 
WRITE A TO CARDS © Writes to acard punch backup file all 


records in file . "“<default 
pack>/(€<usercode>)/A* 


WRITE 10071000 TO PRI Writes to a printer backup file records 
100 through 1000» inclusive. 


WRITE *€<usercode>)/A Writes to a printer backup file att 
records in file "C<usercode>)/A". 


Note that the AUTOPRINT facility cannot be utilized if CANDE is 
not executed under a usercode. . . 


Alehel2s RESEQ etn! 


The RESEQ command assigns new sequence numbers to Lines in the 
workfile» without changing the order in which the Lines appear. 
The default vatue for RESEQ is a base of 100 and an increment of 
100 for all records in the workfile. 


Syntax: 
RESEQ treet en emer e ese c ewan eran ammnn er enane ann enanan wm ananaanae a>] 
| i. (Pee <bast> Sesser essere eases == >1 ! 
| . 1 ' ! ' 
{-> OVERRIDE ~->1 I-> #<Inc> => { 
I =—o2> t 
i | i 
1-> <s1> set > =<52> THK => Chaser Bets ert eset ew same! 


1 i t { 
{> e*END ~->1 t-> +#<3inc> ==>] 


semantics: 


The base vatue ts assigned as the sequence number of the _ first 
line to be renumbered; each subsequent tine number is equal to 
the previous line number plus the increment value. 
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The *OVERRIDE* option orders CANDE to disregard any sequence 
errors Cfor examples a record with a blank sequence-number field) 
found in the workfile. If "QVERRIDE" is not specified and CANDE 
discovers a sequence error in the original workfile>» it 
discontinues the resequencing operation at the point at which the 
error is found» then informs the user that it cannot continue 
processing the file. When CANDE faits during a resequencing 
operations the "OVERRIDE" option -should be used to recovers 
otherwiser this option should not be used. . 


For example» if CANDE discovers a sequence error while it is 
Loading a filer RESEG@ Cwith the appropriate base and increment 
vatues) ts all that is required in order to resequence the _ file 
property. . 


If a range of sequence numbers is provided (<si>-<s2>)>» only the 


specified part of the workfile is renumbered (by default» the 
entire workfile is renumbered). When this range is provided» an 
initial value must be specified as the <base>. The increment 


(<ince>) for successive new sequence numbers may be specifieds if 
none appearsse the default vatue of 100 ts assumed. 


When resequencing BASIC files» sequence numbers in the text are 
modified to match the new sequence numbers on the appropriate 
records. 


RESEQ does not change the apparent order of the lines. <si> must 


be tess than or equal to <base>» and the <base> plus the number 
of tines times the <inc> must not exceed <s2>+<inc>. 


Examples: 
RESEQ 200 


Renumber the entire workfiles» starting with an initial record 
number of 200 and proceeding in increments of 100. 


RESEQ 100-700 100+10 


Resequence ‘tines 100 through 700% starting with an initial 
record number of 100 and incrementing by 10. 


RESEQ +20 


Resequence the entire workfile>, with a base of 100 and 
incrementing by 20. 


RESEQ@ 1000°1500 1100410 


Resequence records 1000 through 1500s» starting with an initial 
record number of 1100 and incrementing by 10. 
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d1-42132 Operator Commands 


The system operator has certain commands that can be directed to 
CANDE. These commands are “WHO",» “STOP™» “ALL™>» “MAKE™>» and 
*“AUDIT™. $$ The "WHO" command prints a List of usercodes' and 
associated togical station numbers that are currently logged on 
to CANDE. The *STOP™ command brings CANCE to an erderty 
conclusion Cif there are no users logged on). The "ALL™ command 
allows the operator to broadcast a message to all terminals. The 
"MAKE" command attlows the operator to make a station “READY” or 
"NOT READY". The "AUDIT" command allows the auditing function to 
be dynamically started or stopped. 


MAKE Coamand 
Syntax: 
MAKE <--> <lsn> mee newneammemnnmn> READY ~~->] 


I--> NOT =->1 


semantics 


The "READY" flag in the Network Controtler's tables for the 
specified <lsn> 1s changed as requested. 


SIOP Command 


STOP teen en en nn ren ce nnn en nnn nnn => 


fer--> <n minutes> “=~—=>] 
Sesantics: 
The “STOP™ command provides for controlled shutdown of the CANDE 
system within <n> minutes (<n> is optional, with a default of 2). 
When entered at the SPOe the command causes the following: 
ae If no users are logged on» CANDE goes to EQJ. 


bs Each loggedon user is sent the following message: 


CANDE WILL STOP IN <n> MINUTES. PLEASE SAVE OR 
REMOVE ANY ACTIVE FILE ANC LOG-OFF. 


Ce At the same time each ltogged-on station ts reported at the 


SPO. After atl togged-on stations are reported» the 
following message is displayed at the SPC: 
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CANDE WILL ADVISE AUTOMATICALY AT <hhemm:ss.t> 
IF USERS ARE STILL ACTIVE. 


From this points only the following commands are attlowed: 


BYE ~ UPDATE Controt Commands cr?") 
RECOVER REMOVE WHAT 

DCSTATUS SAVE . RESEQ: 

FILES TEACH 


One more page of input records can be prcecessed. from each 
stations so that a page in the process of being edited when the 
"STOP™ occurs will-not be lost. 


Note that no further "single-line" input is allowed» except when 
that line comes from a device with a page size of l» in which 
case it is treated as "one more page of input records» as above. 


ALL other commands receive the following response: 


CANDE TERMINATION IN PROCESS. PLEASE SAVE OR 
REMOVE ANY ACTIVE FILE AND LOG-OFF. 


If <n> minutes elapse and there are still users logged on» the 
following message is displayed at the SPQ: 


SHUT DOWN TIME HAS ELAPSED WITH USERS STILL ACTIVE. 
OPERATOR ACTION REQUIRED. 


None of the above wonditaens changes except that CANDE does not 
advise the operator again. 


The automatic shutdown function is intended for the system 
operator*s conveniences not terminal user inconvenience. To that 


end» CANDE will never shut down while users are active. It is 
the responsibility of the terminal user» however» to log off when 


no activity is anticipated for some time. 


AUDIT Command 


CANDE audits each user-CANDE transaction whenever CANDE is 
executed with enough dynamic memory to handle its auditing 
functions. The AUDIT command allows the auditing capabilities to 
be set or reset without resexecuting CANDE (when dynamic memory 
has been provided). 


The audit file is automatically created if CANDE is executed with 
a dynamic memory size of at least 5760 bits. If CANDE is not 
executed in this fashion» auditing wilt be’ dented if requested 
CNO DYNAMIC MEMORY FOR AUDITING) and CANDE must be re~executed 
with sufficient dynamic memory Ci.e.* a minimum of 5760 bits). 
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Whenever an audit file is closed through the CLOSE option, the 
user should immediately print it with CANDE/ANALYZER» remove it 
from the disk directory,» or change its name so that the next 
CANDE/AUDIT file opened does not cause a “duplicate-file*” error 
condition. Since initialization of the audit file is a 
time-consuming process» the user should be aware that an AUDIT 
CLOSE followed by an AUDIT ON will cause a temporary suspension 
of data comm service by CANDE while the audit file is being 
resinitiatized. . 


ayntax: 
<1ob=nuaber>ax- AUDLI eeees esse eee Hee eeoes<se= ee ae em a ie >t 
i. = ( 
{<--> OFF an om ae wm aH oe a an om me oma» | 
i ee i 
(rc esere=ae wawnee> CLOSE ~->!1 
H - 0 fl ee 
I7> OFF 77>] 
‘Semantics: 

AUDIT Displays the current status of AUDI Ts 
whether it is ON or OFF and whether or not 
the AUDIT fite is open or closed. 

AUDIT ON | Sets the AUDIT option ON and opens and 
initializes the audit file (Cif att was 
closed). 

AUDIT OFF Resets the AUDIT option but leaves the AUDIT 


disk file pointer intact and leaves the 
AUDIT file open so that the next AUDIT ON 


command begins where auditing left off. 


AUDIT COFF] CLOSE Resets the AUDIT option and closes the audit 
| file on disk. The next AUDIT ON causes a 
new audit file o f the same name 
CCANDE/AUDIT) to be created and initialized. 
The duplicate-file restrictions mentioned 
above apply to this command. Note that 
CLOSE is sufficient to close the audit file 
and reset the audit option to OFF» but that 
OFF CLOSE» although redundant» is not 
prohibited syntax. 


CANDE writes an “auditvton"™ and “audit-off" reccrd into the audit 
file whenever the AUDIT option is set or resets» so that those who 
examine the file wilt know the period of time during which 
auditing was not done. 
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ade 42142 ; : 

CANDE is released with the. following segments marked = as 
“jmportant™ for use with Extended Segment Decay and Priority 
Memory Management: . * 


~ €0201) 
(0-02) 
(0207) 
(1-01) 
(1°10) 
, f 
(114) . 
(1,515) : 
(1-16) 
C137) 
(1°57) 
(2200) 


C1511) pee 


Lle4el5-  CANDE/ANALYZER | 
- datroduction 


CANDE/ANALYZER is a companion program to CANDE and is intended 
primarily to aid in debugging CANDE. In an interactive real-time 
program such as CANDE» errors can exist which become evident only 
upon entering some unusual sequence of commands or which invotve 
a particular interaction between two or more users. When such 
errors occurs it is often difficult or impossible to know 
precisely what caused the failure. CANDE/ANALYZER should hetp 
resolve this problem. a 


Two principles guide the analysis process: 


ae Since errors are the exception rather than the rule» the 
performance of CANDE shoutd not be noticeably affected by 


the added function of maintaining an audit file. 


be When an anatysis is required» information should be 
provided which is as comptete and readable as possible. It 
is not possible to know in advance what information wilt be 
useful in isolating errors. 


Analyzer-Auditfile Interface 


If at least 5760 bits of dynamic memory ts assigned at BUJ» CANDE 
creates a trace file (called "CANDE/AUDIT™) and writes 
information about each user-CANDE transaction into that file. 
The CANDE/AUDIT file is organized in such a manner that the time 
required to create the trace is minimized» and is therefore not 
easily read. CANDE/ANALYZER assumes the burden of reading the 
audit file and breaking it down into a format easily read by the 
userae 


ace 


“— 
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CANDE/ANALYZER produces two general types of information: 


ae An analysis of the information included in CANDE/TANK.FILE> 
. CANDE/WORK-FILE» and CANDE/RECOVERY. 


“be. A trace of atl messages sent and received by CANDE. 


oer : » cLeatd Ot BOT th CAR DE Ins 
Structure pf the Audit File ,.,.. 0 U4 ge OT That Pee as fel 
oS .retaven f ft ; ei / NOUIT hat fAcre FE ATE AT Me treet ae 

Atl messages which go through the file, ZMCSQUEUE"™ are written to ae 
the audit file» a circular buffer of 1000 360-byte records. The for 


first record in the file is called the Audit Parameter Block ‘4f ihe 


CAPB) and is initialized by CANDE at BOS Cor when the AUDIT Grit 
option is turned ON) to contain information about CANDE itself woud fe ¢ 
| (compile date and time» job numbers etc.). The remaining 999 
i records constitute the circular buffer» in which CANDE packs as 
\ many as fifteen messages per record. The first four bytes of 


4 each record describe the contents of that record. 


| Optional Features 


: Optional features associated with the CANDE/ANALYZER program are 

\ set through the program switches. Default. (zero) settings mean 

; that the program analyzes the usersresident areas for togged-on | 

i stations only» prints a trace audit fr the last 100 entries» and Ase nat 

| Zipctexecutes CANDE. After analyzing CANDE's works» tanks and 
recovery files» the audit file is Femoveds 


ee the CANOE filer | 
CADE / WORK. FILE And CAMDE /REWVER Y 
euen is Cawve/nuoir is nd? pirat y 


CALdE/ AMAL YER Lil] Aun Luin when the 


CAMDE /NULIT 
2 jiu vo nbt pitatat | 


pisses ot mete, 
pone nsee ea, 
Mey 

+ 


sero 


— eae 
‘ 
1 
i 


7 


Hh ( OADE Eilig CADE /L20W Ko FILE and | 


cesta’ even hoi dhe CALOE/A 1045 6 
FY ws ae 
Falk wo net eft 


l-iS Do not Gta jat anakipo dh LAWUE {leo Le Coit KiKIDE 


The functions of the program switches are detincd as fottows: 


Switch 
0 


Value — 


Function 


Print onty those stations which have the 
“LOGGED-ON* bit in the USER.RESIDENT area true. 


Print all stations. 


ent 


mi 


Print trace audit. 
Po not ‘print trace audit. 


Print analysts of the USER. RESTOENT areas for 
the various stations. 


Do not print USER.RESIDENT areas. 


When printing the USER.RESIDENT areas» also 
print the workfite contents for each user. 


When printing the USEReRESIDENT areas» do not 
print the contents of the workfile. 


: dhe entire trace 
Print Say the. fina: 100 entries of.the trace. 


Print only the final 500 entries of the eouces 
Print Reb aiNEe Nile, loo entries oI the +ACe 
HO no ot 


Zip~execute CANDE- after analyzing the works 
~fhankr and recovery. files. 


De not ziprexecute canoe.“ 
Yo not 
Remove the audit file after analysis. 


De not remove the audit file. 2ffer anatysis ik 
ther @re no OFher Usaccs Of I+ 

Do not print information in the aa apt, 
tank» or recovery fites when they 

are in use or missing. 


Print information in the works» tanks and 
S recovery files even if they are already 

in usee This means that the information 

printed may be of questionable integrity» 

since CANDE may be changing such information 

even as it is being accessed by CANDE/ANALYZER. 
I| 
O 


Print tho grfire Cre taba for gacry use as work 


7 i 


a 


Tre oa: Yalole tor Car VW Me A'S wer KOM IS LUMA 


sete 
pe net PUNE tbo. 2ach Lary tne fake, 
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12.2 TEXT/EDITOR 


l2<l1s Introduction. 


A number of minor changes and enhancements have been included in 
the Mark VII-0 version of TEXT/EDITOR- Each of these changes is 
documented separately in the paragraphs that follow. 


The B 1800/8 1700 TEXT/EDITOR Reference Manual (Cform 441090610» 
dated 7°78) is now available» and reflects syntax and operation 
of TEXT/EDITOR as of the Mark VII-.0 release. Temporary 
documentation on changes not included in the manual is contained 
in paragraph 12.3 of this release document. 


12222 Enhancements. 


Les2sle . 
TEXT/EDITOR is now compatible with File Security» and thus can be 
executed under a non“privileged usercode/password. Section 7 of 


the revised TEXT/EDITOR Reference Manual contains details. on 


operational differences and restrictions when running under File 
Security. . . 


L2ate2e 
The RESTART command now handles recovery of the. patch file>» i f 
one was associated with the workfile being recovered. A message 


is displayed on the terminal to indicate the successful recovery 


of the patch file in such a case» and the PATCH option is 
unconditionally SET. 


122223 : 
The PB command has been iaplemented» attlowing printer backup disk 
files to be displayed on the terminal. The syntax of the PB 
command and a description of its function is presented on = page 
4-23 of the revised TEXT/EDITOR Reference Manual. 


122224 : : 

A new commands BACK» has been implemented. Its function is 
identical to that of the NEXT command>» except that movement 
through the workfile is in a reverse direction rather than a 
forward ay rEC ENON: | : 


1222252 | | 

The scanner used for ‘tie: FIND» REPLACE» and SEARCH commands has 
been totally redesigned -to atlow for lowerwcase Letters in SOL 
and UPL tokens. AS a side benefit» the definition of a "token® 
for workfile types of SDL» UPL» MWMIi» DATA» and PSEUDO has been 
changed to accurately reflect the semantics of each language or 
usagee The new definitions for “token” are detailed on pages 4-9 
through 4°11 of the revised TEXT/EDITOR Reference Manual. 
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1222265 | | 7 
The performance of FIND» REPLACE» and SEARCH when LITERAL is 
specified has been substantially iaproved,. 


D2ehele A : | | | 
For the convenience of users who must also use CANDE» the 
following changes to improve compatibility have been implemented: 


ae CANDE-type abbreviations for a number of command keywords 
are now supported» as welt as one~character abbreviations 
for all workfile types. These abbreviations are not yet 
documented in the TEXT/EDITOR Reference Manuals howevers a 
complete tist is presented in paragraph 12.3-1 of this 
release document. ie. | . 


be The RECALL command. keyword has been changed to SAME. 
RECALL is still allowed for Mark VII.03 -however» it will 
be removed in Mark VIII.0. 


ce The plus sign (+) is now allowed as an optional separator 


between the <base> and <increment> values in the 
<resequence-parameters>. The hyphen (7) is atlowed as an 
optional separator between the <sequence-1> and 
<sequence=2> Cor END) values in the <sequence-range>» and 
between the <column?1> and <column-2> vatues_ in the 
<column-r ange>. 

Ag22282 


Because the MCP now provides for rollout of a program in "WAIT" 
status (that is» a program performing a COMPLEX-WAIT)» the WAIT 
option implemented in Mark VI.1 TEXT/EDITOR is no tonger required 
and has been deleted. . 


1202290 

The performance of the LIST command has been improved by removing 
the transmission of trailing blanks at the end of each source 
tine sent to the terminal. A carriagewreturn controt character 
is now appended to each Line following the last non=btank 
character. This change C€also implemented for the PB command) can 
greatly reduce message transmission times and can result in. lower 
memory requirements for messages passed to the Network 
Controttler. | | 


1222219 : ; | | 
The method by which output messages for the T0831 terminal 
(1200-byte data comm buffer) are handled by TEXT/EDITOR has 


changed slightly. Any output message of 1150 bytes or less is 
sent in one transmission; longer messages are sent in two 
transmissions with a 3"second delay between them. Together with 


the new handling for the LIST and PB commands» fullscreen output 
to the T0831 can often be sent in one transmission rather than in 
two separate transmissions. | 
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12232 Temporary Documentation. 


122301. | a : | 
The following aboreviations to command keywords are now supported 
in TEXT/EDITOR: | 


Keyword . Abbreviations 
copy | WRITE» WR 
CREATE MAKE» ™ 
DELETE DEL 

HELLO HE 

INSERT IN 

LIST 7 L 

LOAD GET» G 
MERGE MER 

MOVE MO 

PRINT Pp 

REMOVE | REM 

RENAME TITLE» TI 
REPLACE REP» FIX» F 
RESEQ RES 

RESTART RECOVER». REC 
RMERGE RM 

SAVE SA 

SEARCH SEA 

SEQ S 

STATUS WHAT 

zip ? 


In addition» = any <file-type> specification can be abbreviated as 
the first character of the <file-type> keyword (for example» 
COBOL can be abbreviated as CC). 


AZ23e2s 

TEXT/EDITOR is released with six segments marked as “important® 
for use with Extended Segment Decay =§ and Priority Memory 
Management. For informations the deck used to mark these 


segments is as follows: 


2? EXECUTE SYSTEM/MARK .SEGS 
? FILE CODE NAME=TEXT/EDITOR; 
2? DATA CARDS 


(0-00) 1 % ZERO 

(0202) 1 % SYNTAX_SCAN 

(0-06) 1 % TOKEN_DECODER 

(0*07) 1 % RECORD_UPDATE_INITIAL 
(0,08) 1 % RECORD_UPDATE_FINAL 
(0-09) 1 % UPDATE 


? END 
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13. SMCS 


A3ele Introduction. 


Included as part of the. MARK VIT~0 software is the initial 
release of the B 1800/8 1700 Supervisory Message Control Syster 
CSMCS). . . 


The Supervisory Message Control System (SMCS) is provided for 
users requiring interactive data communications systems» offering 
the capability of a comprehensive Message Control System (MCS) 
interface to the NOL Network Controller. 


The SMCS can be used for a multitude of applications and by users 
with varying degrees of expertise. The SMCS user need not have 
any knowledge of. programming or of NDL* #£x\howevers a basic 
familiarity with the 8 1800/68 1700 system, the MCP» and the 
application programs to be used is necessary. 


The SMCS program is intended to be the “supervisor” for a data 
communications software system which includes such Burroughs 
programs as CANDE» TEXT/EDITOR» HASP» and RJE» as well as other 
on-line packages of either Burroughs or customer origin. 


The Itlustrative MCS files (MCSI and MCSII) are reteased as 
source file to guide those users who wish to write their own MCS. 
The Mark VIL.0 software release includes MCSI and MCSII as source 
files and SMCS as a code file. MCSI and MCSII are still intended 
to be used only as a guides and are not supported in any way. 


The SMCS is a program product which may. be separately ordered. 
Documentation on the SMCS is available with the program product 
in the form of a printer backup file lLabeled DOCUMENT/SMCS. The 


B 1800/8 1700 SMCS can be ordered through the lLocat Burroughs 
branch office from Program Products Distribution. 
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14. RJE 


14.1. Introduction. 


The Mark VII-0 release of the 6B 1800/8 1700 Remote Job Entry 
(RJE) system contains three seperate RJE software packages: 


ae An NDL Data Comm handler and an SOL INPUT/OUTPUT program 
CRJE/JMCS). . . 

be An SDL Data Comm handler and INPUT/OUTPUT programy (RJE) ¥ 

Ce An SDL Data Comm handler CRJE/DCH). 


l42e22 Enhancements. 
AseZelse RIE/MCS. 


The RJE/MCS program has no major changes for the Mark VII.0 
release. Do 


lhe2e22 RIE 
Three new runctime parameters have been implemented: 


ae IDLE.ON.-LOG.OFF 
be. NO.REMOTE 
ce REMOTE 


The tocat control command .READ has been enhanced to allow 
reading a specified file from a carde disk» or tape device. 


A Remote Terminal Interface has been implemented» which allows 
one or more teraminals to communicate with a single copy of the 


RJE program that is oncttine to a host system using the 
Supervisory Message Control System (SMCS). This remote terminal 
interface is only available to users of the SMCS program product. 
Documentation on the SMCS is supplied in the form of a printer 
backup file Labeled DOCUMENT/SHCS to users of the SMCS program 
product. | ; | 


A4ede3s RJEDCH 


The RJE/DCH program has no major changes for the Mark VII.0 
release. 


el conocer cient omen 1a 
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4423- Known Errors and Restrictions. 


A4e dels | , : 

BCL input files cannot be effectively used because of the 
inability to dynamically change the translate table once the card 
file has been opened. 


14e3220 

The. RJE/MCS program at times ctoses. the print or punch fite 
before the last buffer is processed if the host system sends an 
£OF record at the end of the data streams. This occurs because 

the EOF record is sent to a queue which differs from that of the 
output stream» and may be processed before the last buffer of the 
output stream. . : 


14242 Temporary Documention.— 
L4-4e]- Run-Time Parameters 
IDLE .ON.LOG.OFF 


When running on leased lines and the host system terminates the 
session» the RJE program will attempt to reestablish the Data 
Comm link. If this feature is not desired» the [DLE.~ON-LOG.OFF 
parameter causes the RJE program to place itself in an IDLE 
State whenever the RJE program togs off the host system or 
whenever the host system terminates the Data Comm tink. — The 
RJE program resumes normal operation whenever it receives a 
message from the host system or when the RJE program has 
something to send to the host system. 


Default: The RJE. program establishes the Data Comm link 
whenever the Data Comm Link is broken if using a 
leased Line. . 


NO-REMOTE 


This parameter requests the RJE program not to open a remote 
file for communications with the SMCS. This parameter also 
overrides the program switch 9 setting. 


Default: No remote file is opened. | 

REMOTE 
This parameter instructs the RJE program to read from a remote 
file and process the messages as if they were entered from the 
Remote Supervisory Console keyboard. This option can only be 
used in conjunction with the SMCS program product. 


Default: No remote file is opened. 
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‘Uhahe2s «READ or .RE (Read) Local Controt Command 
The eREAD Cor .RE) command has the following format: 
«READ €<device type>] (<*filename”>]) ({<controtl character>] 


The -READ command causes the RJE program to open aie card-image 
file and begin transmitting the data to the host system. When 
endtof~file has been detected the card-image file is closed. One 
eREAD command is required to read each card-image tile. 


The .READ command is only vatid if the RJE program has been 
properly loggedson to the host system. It is possible’ to 
override this feature by entering the -RY CR tocal command. 


The <device type>» <"filename™>> and <controt character> 
parameters are optional and can be entered in any sequence 
following the -READ command. . 


The <device type> specifies the type of device the RJE program is 
to read from» and must be one of the following: 


CARD 
DISK 
TAPE 


The default device type is CARD. 


The <"filename™> specifies the tabet of the file. The RJE 
program uses the filename specified to locate the file on the 
designated device type. The filename must be surrounded by 


quotes (") with no embedded blanks. The default file name is 
"RJE/CARDS". . 


The <control character>» if specified» must be a question mark 
(?). This option informs the RJE program that the file to be 
opened contains controt cards. The RJE program changes question 
marks in column one of all cards to a NULL (2002) code before 
transmitting the record. The host system can then recognize the 
record as a control card. The control character is only valid 
for files on device types of DISK or TAPE. 


Meese 


Exaaples: 


<job*number >AX.READ 

<jobtnumber >AX.RE “"USERPACK/SOURCE/FILE" DISK ? 
<job-number>AX.RE DISK 7? | 

<jobtnumber >AX-READ ? TAPE “"SOURCE® 
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424232 Remote Supervisory Console Output Messages 


The RJE program displays messages in response to local’ control 
messages» or when a condition is detected of which the operator 
should be notified. The new output messages are as follows: 


BEGIN TRANSMISSION <device type> FILE <fitename> 
This message is displayed whenever the RJE program begins 
transmitting a file to the host system. The <device type> is 
either CARD» DISK» or TAPE and the <filename> is the label of 
the file. 


CARD READER ACTIVE WILL TRANSMIT FILE <filename> WHEN READER 
BECOMES AVAILABLE 


This message is displayed in response to a .-READ or .RE_ tocatl 
command. If a file was currently being transmitted to the host 
system when the -READ was entered» the RJE program saves’ the 
Local command and transmits the file when the reader becomes 
available. | 


END TRANSMISSION <filename> 


This message. indicates that the RJE program has detected 
end-of-file CEOF) on the input file and has closed the file. A 
special end-of-file control message is transmitted to the host 
system. | 


REQUEST IGNORED: REQUEST QUEUE FULL 


A READ or .RE local command was entered while the reader was 
still active and the request queue is full ¢€100 entries 
maximum), Re-enter the tocal command .READ after the current 
file has been transmitted to the host system. 


Laetete RIE Files | 
The following files have been added to the RJE program. 
INTERNAL READ REQUEST QUEUE 


Internal Name: REQUEST.QUEUE 
Label: RJE/REQUEST 
Device: DISK RANDOM 


MCS REMOTE FILE 


Internal Names REMOTE 

Label: MCSFILE 

Device: REMOTE (255) WITH HEADERS 
Records: 173/1 

Number Of Stations = 0 
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15s Host RJE 


15-1. Introduction. 


The Mark VII.0 release of the 8 1800/8 1700 Host RJE system 
contains several enhancements over the Mark VI.1 version. Each 
of these changes is detailed in the paragraphs that follow. 


15222 Enhancements. 


1Ds2els 7 | | 
In order to obtain a more efficient utilization of a remote 
terminal and its Data Comm tinere the automatic CALLBACK feature 


has been implemented. A remote user can tog off with the 
CALLBACK option set while jobs are still executing» making the 
Data Comm. line available for another user. Upon completion of 


the original user's jobs» the RJE/CONTROLLER program finds an 

available dialout tine and automatically diats the phone number 
supptied by the remote user. When communication is established» 
all printer or punch output is transmitted back to the remote 
user automaticatly if the RJE AUTOPRINT and AUTOPUNCH options are 


set. Refer to paragraph 15.4.2 for detailed information 
concerning the CALLBACK feature. 
1522.2. 


There is one new Remote Seen uteaey Consote (RSC) command: 
*«PH (Phone Number ) 


Refer to paragraph 15.4.1. for detaited information concerning 
this RSC command. : . 


The following RSC commands have been enhanced. 


*RO CReset RJE Option) 
*SO CSet RJE Option) 

*T0 (Display RJE Options) 
*US (Usercode/Password) 


Refer to paragraph 15.4.2 for detailed information concerning 
these RSC commands. . 


Adee 4e 

An end-of-file 
punch stream. 
RJE/ AUTOBACKUP 


is transmitted at the end of a print or 
an be modified by setting the 
ogram switch 1 to any of the following values: 


0 = Transmit EOF message for both print and punch streamSe 


u 


1 Transmit EQF message for the punch stream but not the 


print streame | 
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2 = Transmit EOF message for the print stream but not the 
punch stream. . 


3 = Do not transmit EGF message for either print or punch 
streams 


1322050. 
The RJE/CONTROLLER program can no tonger be executed without a 
usercode or with a non-privileged usercode. 


1322264 | , | | 
The maximum length of an_ RSC message transmission is 80 
characters. If an RSC message is tonger than 80 characters»e 


multiple records are.transmitted in increments of 80 characters 
to the Remote Supervisory Console. . 


1523.2 Known Errors and Restrictions. 


AS52310 
The Mark VIT.~O0 RJE/CONTROLLER and RJE/AUTOBACKUP programs are not 
compatible with the Mark VI.1 MCP release. 


1324-2 Temporary Documentation. 
2 


eGaks New Remote Supervisory Console (RSC) Command 


The *PH command can be entered in either of the following 
$3 | 


Format 12. *#PH . 
Format 2: *PH = <phone number> 


The *PH tnput command allows the remote system operator toa 
interrogate the current phone numbers or to enter or change the 
phone number to be used when automatically re-establishing 
connection. 


Format 1 informs the remote system operator of the current phone 
number . 


Format 2 allows the remote system operator to enter or change the 
phone number. A phone number is required when the CALLBACK 
option is set and is used for automatically reestablishing 
connection to transmit the remote user's printer or punch files. 
The remote system operator is notified that the phone number has 
been changed by displaying the change on the RSC. 


The phone number can be a maximum of 20 characters in length» 
including dashes as separators. : 
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Exanples: 


*PH 

*®PH 1°222733374444°555 
*PH 33374444 

*PH 1°333°4G44 . 

*PH L*222~-353357-4444 


15-422-2 Enhanced Remote Supervisory Consote (RSC) Commands 
*RO_ (Reset RIE Option) 
Format? *RO <option-name> 


The *RO input command allows the remote system operator to reset 
the options used by the RJE/CCNTROLLER program. RJE/SCONTROLLER 
replies with a verification that the. operon nes been reset after 
each *RO command. 


Refer to the documentation on the *S50 itnput command below for a 
description of the allowable options. 


Examples: 


*RO AUTOPRINT 
*RO CALLBACK 
*RO AUTOPUNCH 


*80_ (Set RJE Option) 


Format: *50 <option-name> 


The *SO input command allows the remote system operator to set 
the options used by the RJE/CONTROLLER program. RJE/CONTROLLER 
replies with a verification that the option has been set after 
each *S0 message. 


There are three allowable run-time remote terminal options: 


AUTOPRINT When this option is sete all print fites are 
automatically transmitted to the remote terminal 
system as soon as the job has been completed» without 
intervention by the remote system operator. 


AUTOPUNCH When this option ts set» all punch files are 

automatically transmitted to the remote terminal 

system as soon as the job has been completed» without 
intervention by the remote system operator. 
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CALLBACK When this option is set» if the remote system operator 
logs off with a job active, connection is 
automatically recrestablished upon completion of that 
job using the phone number supplied by the *PH RSC 
input. command. The printer and/or punch backup files 
are then transmitted to the remate terminal user. The 
Data Comm tine is available for use by other users 
during the time between log off and re~establishment. 


Examples: 


#50 AUTOPRINT 
*SO CALLBACK 
*S0 AUTOPUNCH 


210_(isolay BJF Options) 


The *T0 command can be entered tn either oaf_ the following 
formats: 


Format 1: «TO 
‘Format 2: «10 <option> 


The «TO input command allows the remote system operator to 
interrogate the status of the remote options. 


Examples: 


* 10 
*TO0 AUTOPUNCH 
*T0 AUTOPRINT 
*#T0 CALLBACK 


The *US command can be entered in any of the following formats? 


Format 1: “US 


Format 2: *US <usercode>l€/<password>J PB <options> 
Format 3:2 «US <usercode>({/<password>] PD <aptions> 
Format 4: *US <usercode>{/<password>] RB <options> 


Format 1 allows the remote system operator to obtain a ‘List of 
every remote terminal system in the network by Remote Station 
Number (CRSN). . ; a 


Format 2 allows the remote system operator to initiate the 
“transmission of a print or punch file to the remote terminal that 
was entered under the specified usercode. | 
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Format 3 altows the remote system operator to interrogate’ the 
host system"s output file directory for files entered under the 
specified usercode. 


Format 4& allows the remote system operator to remove entries from 
both the directory and the system that were entered under the 
specified usercode. 


Refer to the *PB» *PD» and *RB RSC input commands in the 
B 1800/8 1700 Remote Job Entry (C(RJE) Reference Manual Cform 
#1090602» dated 7-78) for the syntax of the <options>. . 


Examoles: 


*US . 

*US PAYROLL /ACCT PB J 125 

*US PAYROLL /ACCT PB = LABELS | 
*US LEDGER/FILE POD J 495 

*US PAYR PD = 

*US PAYR RB S 1001 

*US PAYROLL/ACCT RB 87 


1524-3. New Remote Supervisory Console ¢(RSC) GQutput Messages 
#BYE ABORTED» NEED PHONE NUMBER 


Originator: RJE/CONTRCLLER 


The CALLBACK option was set but no phone number was available 
for the automatic CALLBACK feature. 


#BYE ABORTED» NO DTALOUT LINE AVAILABLE 


Criginator: RJE/CONTROLLER 
The DIALOUT hardware is not present. 


#CALLBACK ABORTED» NO. JOBS ACTIVE 


Originator: RJE/CONTROLLER 

This message indicates that the automatic CALLBACK option was 
set and the remote terminal has logged off without any =jobs 
executing at the host system. 


#T0 BE CALLED BACK 


Originator? RJE/CONTROLLER 

This message indicates that the CALLBACK option has been set 
and a phone number’ entered. The remote terminal is 
automatically called back when the first job executing has 
completed. When re-establishment has occurred with the remote 
terminal>» the print or punch backup files are transmitted to 
the remote terminal. 


15 ebede RJE Host System Output Messages : 
#INCONSISTENCY BETWEEN LSN*S OF RSN 


Originator: RJE/CONTROLLER . ) 
This message indicates that a possible hardware malfunction 


occurred. — An automatic program DUMP is produced and 


RJE/CONTROLLER goes to EOJ. 


#ILLEGAL TERMINAL TYPE 


Originator: RJE/CONTROLLER 

This message indicates that a possible hardware matfunction 
occurred. An automatic program DUMP is produced and 
RJE/CONTROLLER goes to E0J. . 


#INVALID LSN FROM STATION STATUS 


Originator: RJE/CONTROLLER 7 
This message indicates that a possible hardware malfunction 


occurred. An automatic program OUMP is produced and 
RJE/CONTROLLER goes to E0J. 
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16-2 RJE 3780 


16-1. Introduction. 


Included as part of the Mark VII.0 software is the initial 
release of the B 1800/8 1700 3780 Remote Job Entry (RJE) system. 


The 8B 1800/8 1700 RJE 3780 program allows the remote user to 
transmit queries» programs» and data files to a central computer 
for processings and upon completion» to receive the final printer 
or punch output at the 8 1800/8 1700 remote computer. The 
central system must be using the IBM 3780 Data Comm 
characteristics. 7 . 


The RJE 3780 system is a program product which may be separately 


ordered. Documentation on the RJE 37860 system is available with 
the program product in the form of a printer backup file labeled 
DOCUMENT/RJE 3780. The 8B 1800/B 1700 RJE 3780 system can be 


ordered through the local Burroughs branch office from Program 
Products Distribution. | | | | 
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17. HASP 


17-1. Introduction. 


The Mark VII.0 release of the B 1800/B 1700 HASP system contains 
several enhancements over the Mark VI.1 versions including new 
‘Local commands» improved performances hot readers» and a remote 
terminal interface. 


1722-2 Enhancements. 
A222e1-. HASP 
The following problems have been corrected: 


ae The alternate file is reset after a secondary file is 


opened» causing the next SR tocal command to read the 
correct file. — ; 


be. Punch files may now be routed directly to the punch device 
instead of going to punch backup first. 


Ce “Waitraw“bit™ is now set for a stream as soon as a- record is 
queued (that is» when the line printer gets behind). 


de The HASP program now counts consecutive timeouts = and 
displays a message every 15 timeouts as an indication that 
the host is no longer accepting transmission. 


e. The Functional Control Sequence (FCS) character is checked 
for “waittacbit™ on duplicated transmission blocks. 


AZ22222 HASP/MODIFIER 
The following two run-time parameters have been added: 


REMOTE 


The REMOTE parameter is used to order the HASP program to open 
a remote file and to process messages read from that remote 
file. <A Network Controller and the Supervisory Message Control 
System (SMCS) are required in order to use the remote terminal 
interface. The remote terminal interface cannot be used in the 
Spool Mode. Roe end 


MEM=<integer> 


The MEM parameter is used to inform HASP/MCCIFIER how much 
dynamic memory the HASP program is to use. The <integer> must 
be equal to or greater than the minimum dynamic memory. The 
minimum dynamic memory can be calculated by using the following 
expression: 
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(CBUFFER + 34) «© & ® 8 + CCMAX.PRT + MAX. PUN) * 1211) + 
CIF PUNCH = 96 nen 512 * 8)) 


If the MEM parameter is not used» the HASP/MODIFIER procram 
calculates dynamic memory using the fottlowing expression: 


(CBUFFER + 14) * & * 8 + COCOMAX.PRT + MAX.PUN) * 1211) * 
C10 * 1085)) # CEF PUNCH = 96 THEN 512 * 8)) 


17-2236 HASP - Direct Mode 


Two new Local commands have been implemented» as follows: 


eHRn CHot Reader) 


WHAT (Display Reader Status) 


' Changes have been made to the following three tocal commands: 


eE0Fn CEnd-of-File) 
~-GOn (Continue transmission) | 


-S (Start Reader) 


The following local command has been deleted: 


-JCLn CJCL Reader) 


Refer to paragraph 17.4 for a complete description of the new 


local commands and the new functions of the existing local 
commands. . 


A Remote Terminal Interface has been implemented>, which allows 
one or more terminals to communicate with a single copy of the 
HASP program that is onetLine to a host’ system, using the 
Supervisory Message Control System CSMCS).~ This remote terminal 
interface is only available to users of the SMCS program product. 
Documentation on the SMCS is supplied in the form of a printer 
backup file labeled DOCUMENT/SMCS to users of the SMCS program 
product. . 


AZe2e42 %HYWASP - Direct Mode and Spool Mode 
The maximum number of output devices allowed has been changed 


from 8 to 7 The sum of the values Specrt weed in MAX-PUN=n— and 
MAX-PRT=n must not be greater than 7. 


ae 


aR ae ch 


LfZe32 Known Errors and Restrictions. 


IfZesels . . ois 
The HASP program enters an indefinite wait loop at midnight due 
to the system clock being set to zero by the MCP. 


“(1723225 ; | 
\JThe program name “HASP™ cannot be chanyed to any other name when 
using the Supervisory Message Control System (SMCS) remote 


terminal interface. 
ts 


LTfZe4- Temporary Documentation. 
dZe4sle HASP in Direct Mode 
-EOFn | 


The. eEOFn tocal ‘command instructs the 8B 1800/8 1700 HASP 
program to stop reading from an input reader and to send the 


end-of-stream indicator to the central system. The tetter "n" 
in the -£OF command specifies the reader number from which the 
HASP program is to stop reading. The -€QFn command also 
deactivates the specified reader. This command 1s only vatid 
“when a secondary file specifier was not found. The «SD» «SR» 


and .ST commands explain the use of secondary file specifiers. 


«GOn 


The .GOn local command instructs the B 1800/8 1700 HASP proorar 
to continue reading from an input reader. The letter “n™ in 
the .GO command specifies the reader number from which the HASP 
program is to continue reading. This command is onty vatid 
when a secondary file specifier was not: found. The .~SD- .SR» 
and .ST commands explain the use of secondary file specifiers. 


«Hn 


The -HRn tocal command allows the user to permanently. assign a 
card reader device to the HASP program. The optional tetter 
“n" in the -HR command specifies the reader number from which 
the HASP program is to read and» if used» must be a value 
between 1 and 4» inclusive. The reader number cannot exceed 
the value of the MAX-RDR run-time parameter. 


Each reader has a separate file» having internal file names of 
INPUTO through INPUT3. The numeric portion of the name is the 
reader number minus one. 


If the «HR Locat command is used without specifying a reader to 
be used» the HASP program uses the first non-active reader. 
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The »HR command allows the user to dedicate a card reader to 
the HASP program. The user may transmit a card deck to the 
central computer by entering the deck into the card reader» 
eliminating the need to enter the .5 tccat command on the 
console keyboard. The following rules must be adhered to when 


using the .HR local command: 


the following card 


ae When the eHR command is initiated» 
HR command: 


must be fed into the reader assigned by the 


~--- 29STREAM HASP/CARDS 
ts Label HASP/CARDS cannot be changed. 
ed 


{ 
bej Any card deck can be transmitted to the centrat computer 
| by placing the card deck in the read hopper of the card 
j reader and pressing the START button. The first card of 
| the card deck must have the following format: 
| 
i 


~~? DATA <filename> 


Cannot contain any embedded 


i lcard columns 1 through 5 
name or two 


| spaces. The file name can be either one 
names separated by a Slash. 


] 

| 
c. | The last card in the card deck must have the following 

| 


\ format: 
\ 
—~. PEND 


Card columns 1 through 4 cannot contain any embedded 


spacese 


d.| To release a reader from the .HR commands erter the 
following card through the card reader: 


VA? TERMINATE HASP/CARDS 


Examples 


PSTREAM HASP/CARDS 
?DATA CARDS 

5D MICR/JCL1 

03D MICR/FILEL 

SD MICR/JCLENDI 


2END 
DATA CARDS 


9D MICR/JCL2 
SD MICR/FILE? 
03D MICR/JCLEND2 


aS 
A CARDS 


pitesti JOB €123456>» 123456 eHDH) »CLASS= A» TIME=8 
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J/LIST EXEC COBUCLG»PARM. COB= "LOADS 
//COB.SYSPUNCH OD SYSOUT=6& 
J/COB.SYSIN DD «* 

<source deck> 
Po 
//LKED. SYSDUMP DD SYSOUT=A 
4//G0~.SYSPRINT DD SYSOUT=A 
//G0. eSYSIN DD * | 


<input data>_ 


?END 
?2TERMINATE HASP/CARDS 


«San <filename> 


The «S Local command causes the HASP program to read a_e file>» 


compress the datas and transmit the file to the central 
computer. The letter “a” in the .S command specifies the type 
of device from which the HASP program is to read. The 
following is a List of valid i~character mnemonics: 

D = Disk 

R = Card Reader 

T = Tape 


The Letter "n* in the .S command specifies the reader number 
from which the HASP program 1s to read» and must be a vatue 
between 1 and 4s inclusive. If the reader number is useds no 
queuing of the command is done if that reader is active. 


The <filename> in the .S command is the tabel of the file. The 


HASP program uses the <filename> to locate the file on the 
specified device. 


The maximum number of readers that can be active at one time is 
determined by the runstime parameter MAX.RDR. Each reader has 
a separate filter having internat names of INPUTO through 
INPUT3. When the .S command is entered to the HASP programe a 
search is done to find a non-active reader. 


If a nonactive coder is founds the file 3s marked active and 
the file is opened using the file mame and device type 
specified. If the file is not found» the HASP program disptays 
a message and the operator must reenter the command. 


If all readers are active and _ the reader number was not 
‘specified in the .S command» the HASP program queues the 
coamand and notifies the operator that the command is queued. 
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When a reader becomes nonmactives the queued ccmmand is read by 
the HASP program and the operator is notified that the command 
is in process. 


If the reader specified in the .S command is actives» the HASP 
program notifies the operator that the reader is active and the 
-5 command is not queued. The operator must rectenter the 
command when the reader is not active. 


Multiple job steps may also be built and transmitted to the 
central computer. as a single job to be executed seriatly by the 
central computer. The data being sent to the central computer 
can be on disk» tapes or cards. 


In order to create multiple job steps to be executed serially» 
the Local commands «SD» .SR» and -ST have been made available 
and can be included as a part of the input file. The .SDs .SR» 
or 5ST commands start in position one of the card image. 
Position four must be blank. The file name of the data file 
starts in position five. Any number of «SD» «SR» and -ST local 
commands may be included as a part of the input file. 


ALL card images that do not have -SD+ .SR» or «ST in the first 
three character positions followed by a blank are transmitted 
to the central coaputer. 


When etther .SD» .SR» or .ST is detected» the B 1800/8 1700 
HASP program stops reading from the primary input file and 
modifies a secondary fite to the device type and file name 
specified. This secondary file is then opened and transmitted 
to the central computer. When the secondary file has reached 
end~of-files that file is closed and input is read again from 
the primary fite. If the next card image contains a tocal 
command this same procedure is performed? otherwise» the card 
is transmitted to the central computer. If. the secondary file 
contains «SD» -«SR» or «ST local commands» they are treated as 
data and transmitted to the centrat computer. 


The end-of-stream control message is sent to the centrat 
computer when the primary input file has reached end-of-file>, 
or when explicitly requested by the 8 1800/8 1700 HAsP 
operator. Refer to the .EOFn tlocal command for additional 
information. 


An error wilt occur when using the -SD» .SR or .ST Local 
commands and the secondary file is not present. If the file is 
not present», the 6 1800/8 1700 HASP program waits fer an 
operator response to continue reading (€-GOn command) from the 
input file or to terminate (.E0Fn command) the job stream and 
send the end-of-stream message to the central computer. 
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When the secondary file is not presents» the operator has three 
options: . . y a: % 


ae Correct the card and place it back into the card reader. 
be Bypass the record and continue. 


ce Close the input file and send the end-of-stream message 
to the centrat computer. 


The B 1800/8 1700 HASP operator ’s response for items a and b is 
the Locat command -G0n» and -EOFn for item c. 


The correct format and sequence of the job stream transmitted 
in this manner is the responsibility of the user. 


The following is an example of how the merging of secondary 
files can be performed. Assume that the operator enters the 
following command to the HASFP program: 


<job™number>AX.SR CARDS 


The HASP program identified by <job-number> opens a card file 
tabeled CARDS» which contains the following information: 


2DATA CARDS : 
5D MICR/STARTJCL 
09D MICR/FILE1 

»SD MICR/FILE2 

oST MICR/FILES 

°~SD MICR/ENDJCL 
2END CARDS 


The files tabeted MICR/STARTJCL» MICR/SFILE1L»> and MICR/FILE2 are 
transmitted to the centrat system from a disk device. The file 
Labeled MICR/FILE3 is then transmitted from a tape device. The 
file tabeled MICR/ENDJCL is then transmitted from ae disk 
device. When the HASP program has detected ENF on the file 
Labeled CARDS» the end-ofe-stream indicator is transmitted to 
the central system and the file tabeled CARDS is closed. 


eWHAT 


The eWHAT = local command allows the HASP user to inquire about 
the status of all readers. A typical response would be 
formatted as follows: 


READER 1 HOT READER 
READER 2 NOT ACTIVE 
READER 3 CARDS ON RECORD 53425. 
READER 4& NOT ACTIVE 


179 


18. System Utilities 


18-1. Introduction. 


This section contains descriptions of new system utility programs 
(reteased for the first time on Mark VII.0)> as well = as 
modifications and enhancements made to existing system utility 
programs. Documentation on the following programs is included in 
this section: . 


CHECK/LOAD «DUMP Disk Pack Initializer CPACK/INIT) 


CODE /ANALYZER | QWIKLOG 
COLDSTART/DISK | SORT . 
COLDSTART/TAPE STANDALONE /DISK.DUMP 
DISK/ALLOCATOR SYSTEM/BACKUP 
DISKETTE/COPY SYSTEM/COMPARE 
DISKMAP/UTILITY SYSTEM/DISK.INIT 
DMPALL SYSTEM/ICMD.INIT 
DUMP/ ANALYZER SYSTEM/ELOGOUT 
LOGCONVERT SYSTEM/MAKEUSER . 
MCPII/ANALYZER SYSTEM/MARK.SEGS 


The following utilities have received either no changes or only 
minor modification tin order to insure compatibility with the Mark 
VIIT.0 system. Separate documentation on them is not inctuded. 


Disk Cartridge | SORT/VSORT 
Initializer CCART/INIT) SSLOAD/MAKCAS 


CASSETTE/MAKER ST ANDALONE/ INTERCHANG 
DISK/COPY SYCOPY. He 
DISK/DUMP SYSTEM/BUILCTRAIN 
DISKP ACK/LNTERCHANG SYSTEM/DISK «DUMP 
FILE/LOADER | SYSTEM/LDCONTRE 
FILE/PUNCHER | SYSTEM/LOAD.CAS 
SORT/COLLATE | SYSTEM/LOAD.DUMP 
SORT/MERGE SYSTEM/LOGOUT 
SORT/QSORT SYSTEM/SPOLOGOUT 
SORT/TAPESORT TAPECOPY 


A comptete description of the functions. and related syntax of 
each system utility program is contained in section 3 of the 
revised System Software Operational Guide. 


fe: 
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1822- Enhancements. 
AB-2el- CHECK/LOAD.DUMP 


ae If CHECK/LOAD-DUMP is executed with switch 2 set toa 
“non-zero valuer the output Listing will not be printed. The 
total number of errors detected on the tibrary tape will be 
displayed on the SPO at E0J» regardtess of the setting of 
switch 2. . | 


be. If CHECK/LOAD-DUMP is executed under a usercode/password and 
switch 0 is set to a non-zero value» MCP File Security naming 
conventions apply to file-identifiers entered through ACCEPT 
messagese That is»  usercodes are implicitly added _ to 
single-name fileridentifiers (Cuntess the first character is 
an asterisk). If CHECK/LOAD.~DUMP added the usercode to the 
filecidentifier and the file could not be found in the tape 
directory,» the usercode will te removed and a second scan of 
the directory will be made to attempt tc find the file. 


18.2222 CODE/ANALYZER 


CODE/ANALYZER indicates on the out put Listing any code segments 
that are marked as *important"» for use with Extended Segment 
Decay and Priority Memory Management. . 


18.223. COLDSTART/DISK 


A problem that: could -cause “NO AVAILABLE OCISK™ conditions 
following COLDSTART of a:-head~per~track disk has been corrected. 


18-224. COLDSTART/TAPE . 


COLDSTART from tape now accepts 7~track tapes having labels 
written in either even or odd parity. 


18-2232 DISK/ALLOCATOR 


This is the initial release of DISK/ALLOCATOR» a program used to 
create Installation Allocated Disk files. ‘Such files are created 
with usercspecified attributes and absolute disk addresses. 
Refer to the revised Software Operational Guide for comptete 
documentation. . 


1822262 DISKETTE/COPY 


ae DISKETTE/COPY now has a provision for relabeling diskettes» 
using the RL input command specification. 


be DISKETTE/COPY now recognizes the diskette file BYPASS flags 
allowing files with duplicate names to exist on the same 
diskette. , 
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ce There is now a- provision for automatic Loading o f 
pseudocreader files from a diskette to systems disk. When a 
diskette is readied by the MCP» the diskette is scanned for 
any files having the first three characters of the filename 
equal to "PSK". If the MCP finds one or more such files» 
DISKETTE/COPY is automatically executed» which then copies 
the pseudov-reader files from the diskette ta systems disk. 


18-267. DISKHMAP/UTILITY 
When analyzing a disk with neither MAP nor CHECK specified» it is 
no longer necessary for all activity on the disk to cease during 
Phase l. 


482228. DMPALL 


as In order to simplify operations the three functions provided 
by program switch 9 have now been broken down into separate 
switches. If switch 7 is set to Ll» ODMPALL terminates after 
performing the current specification. If switch 8 is set to 
1» card output files are not interpreted. If switch 9 is set 
to Ll» input file errors are ignored. 


be Setting switch 1. to 1 while DMPALL ts performing a function 
now causes DMPALL to immediately terminate the . current 
function and go on to the next input specification. DMPALL 
automaticaily resets switch 1 tc 0 in such a case. 


c. The KEY» SEARCH» SELECT» and EXCLUDE options have been 
expanded to atlow comparison on bit Gr digit boundaries 
within a record. 


d.- DMPALL now can access COBOL and RPG indexsequential files ir 
a sequential manners» using the associated TAG file. 


Refer to the revised Software Operational Guide for syntax and 
detailed information on alt of the above enhancements. 


1822292 OUMP/ANALYZER 


The NC option of the PM input message is no tonger allowed by the 
MCP. A change has been made to DUMP/ANALYZER to recognize that 
the dumpfile being analyzed is that of an NOL Network Controller; 
if so» eoNOL/DUMP is z2ipvexecuted automatically following the 
standard memory dump analysis. , 

18.42210- LOGCONVERT 

a. Several new record types appear in the tog when the TABS 
option is sete “These records tog the opening and ctosing of 
files» the transfer of the log filer» and the assignment and 
release of peripheral units by specitat "Direct [/0" programs 
(such as SYSTEM/OISK.INIT). Refer to the revised Software 
Operational Guide for the format of these new records. 


LB2 


be The CLEAR/START kecord has a number of additionat fieldsr 
including the GISMO and MICRO.MCP file-identifiers and the 
setting of the TABS option. The MCP VERSION field has also 
been increased to 10 pytes in Lenyth. Refer to the revised 
Software Operational Guide for the complete format of the 
CLEAR/START Record. a 


Ce Within the PPB and FPB recordse the Job Accounting Number and 
Job Number. now appear in place of the Jcb and Mix numbers,» 
respectively. Due to a change in the size of both these 
fields since Mark VI.i». and to other output record format 
changes» programs which process the LOGCONVERT output file 
must be modified. Refer to the revised Software Operational 
Guide for the new layouts of all record types. 


d. LOGCONVERT now verifies that it is teing run under the 
correct software retease and terminates if there is a 
mismatch. ‘This process ensures the validity of the 
NEWLOGFILE data. se ean 


1Bs2elle MCPII/ANALYZER 


‘Due ‘to a change tn the Layout of memory by the System 
Initializer»  MCPII/ANALYZER is now able to perform the Code 
Segment Comparison operation on seqment zero of the MCP Cwhich 
could not be done in Mark VI.1). 


Code segments 9 and 10 of the MICRO.MCP are stitl the onty 


comparison failures that should tbe expected to occur with Mark 
VII.0O. , : 


1822012. PACK/INIT and SYSTEM/DISK.INIT 


ae The initialization specifications have been changed» atlowing 

explicit error timits to be. supplied to the initializer. 

Refer to the revised Software Deer erro Guide for complete 
syntax of ait specifications. 


b. A RECONFIGURATION option is now avatitable which atltows 
changing the pack type. For exampler it %5 now possible to 
reconfigure a pack that was previousty initialized as. 
UNRESTRICTED CU) into a SYSTEM (S) pack. Reconfiguration is 
available only if the pack was initialized by the Mark VI.1.1 
or Mark VII-O PACK/INIT or SYSTEM/DISK-INIT» and the Master 
Available Table on the pack is good. If reconfiguratian i565 
requestede the pack is purgede verified» and the type is 
changed as specified. 
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Reconfiguration can he requested when using either SPO or 


card input. If entering specifications oan the SPO» ~> the 
following message is displayed if the initializer encounters 
a pack that can be reconfigured (that is» the pack was 


initialized by at least the Mark VI.1.i initializerr and has 
a good Master Avaitable Tattle): 


[S RECONFIGURATION DESIRED? <YES OR NO> 


If a YES response is entered, the initiatizer displays the 
following request: 


ENTER PACK TYPE = <Us Se» Re OR I> 


Once the. appropriate response has heen entered>- the 
reconfiguration process is initiated. 


Reconfiguration can be requestec when using card input 


specifications by. including an RR betweer the <drive> and 
<serial-number> Parameterse 


sOTE 


LIN #8290-002 must be installed in the Disk Pack 
Controt in order to atltow retocation cf marginal 
sectors on B 9484°25/8 9464°55 Disk Packs when using 
either of the new Disk Pack Initializers. Without this 
LIN» an attempt by the initializer to. initiate a 
RELOCATE operation witl result in oa system halt or 
hang» requiring manual clearing of the Disk Pack 
Electronics Controller (OPEC). 


1822015. QWIKLOG 


ae 


The Mix Number has been replaced by the Job Accounting Number 
in both the Job Summary and Graph Listings. The Job 
Accounting Number corresponds in principle to the aotd Job 
Number in that it continuously increment se thus providing a 
unique identification number for every job. It is» however, 
accessible only to programs which process log files. The Job 
Number is a-vatue which increments from 1 tc 9999» and then 
is reset back to 1. This number now identifies the job in 
alt MCP input and output messages» some of which previously 


used the mix number and others of which used the job number. 


Memory Priority is now included in the Job Summary tistings 
appearing on the same tine as the Schedule Priority and 
Processor Priority. 


Att uses of speciat characters not on the basic 48&*character 
print train have been replaced with legal characters. 
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d. Abnormally-terminated jobs area now spotlighted in the Graph 
Listing by replacing the “C" or “E" character for the last 
minute of any DS-ed or Atorted job with an "X". 


e. The setting of the TABS option has no effect upon the output 
of QWIKLOG. Records generated by the MCP when the TABS 
option is set are ignored. . 


f. Two formatting irregularities within the Graph listing have 
been fixed. | A job name component whose only special 
character is a leading asterisk (for examples *AARDVARK) is 


no tonger quoted- <A job with an empty file~id component on a 


user pack (Csuch = as USERPACK/YAK= TALLY/) now shows the 
trailing slash character which was omitted in the Mark VI.1 
QWIKLOG, 


gs QWIKLOG now verifies that it is being run under the correct 
software release and terminates tn case of a mismatch. This 
ensures the validity of the printed cutpute as the meaning 
and fornat of tog records is subject’ to substantial change 
between software releases. 

18222142 SORT 

ae A COLLATE table can now he specified directly in the SuRT 


specifications» without the necessity of creating a. file 
separately using SORT/COLLATE. : 


be SORT can now produce an output TAG file compatible with CoBot 
or RPG index=sequential files. 


Ce The SORT output file is now expticitly closed; therefore>s 
the output file no tonger remains on disk or causes an 
existing file to be removed if the SORT intrinsic is DSwed. 


d. The “STABLE” option has been added» which allows the original 


order - of records with duplicate keys to be maintained in the 
output file. a 


e. The SORT/SKELETON file is no Longer required (nor is it used) 
when compiling a SORT program to LIBRARY. 


18s2215- STANDALONE/DISK.DUMP 


This is the initial release of STANDALONE/DISK.OUMP, a 
disk~to~disk copy program that ooerates in a manner similiar to 
DISK/DUMP. STANDALONE/DISK.DUMPs however» copies the files on 
the input disk individually,» rather than copying the entire disk 
Csectorsby-sector). This results in a "squashed" output disk» as 
well as allowing the input disk to have "XD~ed" areas. Refer to 
the revised Software ae atk Guide for details on this system 
MEME EY, program. 


ied tage 
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182016. SYSTEM/BACKUP 


ae Problems which caused multipte coptes cf scme Listings to not 
begin on a new page have been corrected. 


b.- Problems involving requests to print/punch allt files on a 
backup tape (that is» PB MIx =/=) have heen corrected. 


ce Backup files with SPECIAL FORMS specified are now explicitly 
ignored by the AUTOPRINT mechanism. © 


de A backup file created with the USER.BACKUP.NAME attribute its 
no tonger removed from disk by SYSTEM/BACKUP ” following 
printing /punching. If SYSTEM/BACKUP switch 2 is set to Il» 
however» such: backup files will be removed untess the SAVE» 
KEY» or RECORD option is specified tin the P#& input message. 


18.2217. SYSTEM/COMPARE 
This is the initial release of SYSTEM/COMPARE, a utility program 
which can compare any two fites. | SYSTEM/COMPARE ‘prints any 
records that fail to compare in both EBCDIC and hexadecimat 
representationse flagging each hexadecimal digit that is in 
error. Refer to the revised Software Operational Guide for 


details on this system utility program. 
1822018. SYSTEM/ELOGOUT 


This program has been completely rewritten in order to provide 
more detailed and comprehensive output. Errors are now reported 
in chronotogical order» sorted by unitemnemonic and hardware 
address. Appropriate totals are summarized at the end of the 
output listing. Result descriptors and Extended Result 
Descriptors for errors on pertpheral units are summarized and 
decoded. . Errors on disk devices are sorted into ascending 
sequences summarized by address and data transfer lengthe and 
decoded into the actual hardware tocations (cylinderr track» and 
sector). 


18222192 SYSTEM/ICMD.INIT 


This is the initial release of SYSTEM/ICMD.~INIT»+ a program used 
to initialize diskettes. Refer to. .the — revised Software 
Operational Guide for detaits on this system utility program. 


1822220. SYSTEM/MAKEUSER 


ae If there are other jobs in the mix» SYSTEM/MAKEUSER requests 
verificatton before performing a CREATE. If programs are 
running under File Security when a CREATE is performed» 
unpredictable results can occur. 


166 


be SYSTEM/MAKEUSER now checks to ensure that identical usercodes 
have the same default pack-id and security type CPLBLIC or 
PRIVATE). 


ce The external names of both the input and output card files 
have been changed to NEW/USER.CODES. — | 


1822221. SYSTEM/MARK.SEGS 


This is the first release of SYSTEM/MARK «SECS» a program used to 
mark specific program code segments as important for use with 
Extended Segment Decay and Priority ‘Memory Management. Refer to 
the revised Software Operational Gua" for details on this system 
utility program. 


18.23. Known Errors and Restrictions. 
UWWedels COLDSTART/DISK 


If there are pseuda decks on the input system diske they wilt be 
copied to the output disk if 3 complete copy is requested. Such | 
decks will be unusable» however» and cannot be removed. 


18.342. DISKMAP/UFILITY 


In Mark VII.-O» the MCP does not allow a user disk to be accessed 


by a normal-state program unless the program has. exclusive use of 
the diske Therefore» it will stilt be necessary to cease alll 


activity on the user disk prior to the start of Phase 1 in 
DISKMAP/UTILITY. This witl be corrected in the Mark VIII.0O MCP. 


1825232. © OWTKLOG 


Jobs terminated due to DEATH IN FAMILY are Listed as "ABORTED" in 
the Job Summary. This MCP problen witl be corrected in the Mark 


VIII.0 software release. 


1823242 SORT 
If a SORT parameter ends in position 96 of an input specification 
records» an erroneous syntax error may be generated. 

18.3425 SYSTEM/BACKUP | 

If either an output unitemnemonic or COPIES is specified in the 


PB input messages the backupo fite is not removed from disk after 
printing/punching.- ; | 
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19. 6 500 and 1400 Interpreters 


12212 Introduction. 


This section contains descriptions of the Mark VII-0 enhancements 
to the B 500 and 1400 Interpreters» and the associated changes to 
the B 500 and 1400 Interpreter Environment Programs CIEP). 


12:22 8B 500 Interpreter and LEP. 
1 


The B 500 Interpreter now supports the Magnetic Tape Memory Write 
(MWR) B SOO operator. . 


AQalels . a 7 . a . 
. The 8B 500 Interpreter now supports 8 500 double density disk. 
~The titerat -"DOUBSLE.DENSITY™ must be included in the IEP 
specifications for the EU to enable the double density mechanism. 
For example: 


EUO NAME = A/8> iia 


A 8 500 EU B 1800/8 1700 disk file must have been created (the 
"NEW" attribute set) with DCGUBLE.DENSITY in order for the 
B 1800/8 1700 file siza to he ik eneuge to contain the 400-000 
B 500 disk segments. 


4222232 : | 

The £05 9399 option has been changed and enhanced. The literal 
"EOS.999" is no longer recognized in the 8 500 LEP 
specifications. The new syntax is “EQJ = <3 characters>s™" Cthe 
equat sign is optional). The first of the <3 characters> must be 
the digit "9", and must be fotlowed by two digits or characters. 
When the 8 500 Interpreter executes a 8 500 halt instruction with 
the M and N variants equal to the two digits cr characters» a 
B 1800/8 1700 endtofcjob occurs. For example: 


EOS = 9993 
EOU 9893 


iT 


The B 500 Interoreter command “E0J999" has also been changed 
accordingly. The new syntax is "EQJ<3 characters>",s where the 
<3 characters> format is the same as in the IEP specifications. 
For example: 


<job-number >AXE0J989 


When executed with program switch 9 set to 1 and EQJ not 
specified in the 8 500 TEP specifications» then the EOJ defaults 
to E0J=999. 
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19.3. 1400 Interpreter and IEP. 


A92321- | Eo eae a aT 
A provision has been added to the INTOPT options to allow 1400 
object program decks to be separate from the data decks. When 


the INTOPT card “ENTOPT SYSIN". is. encountered» the 1400 - 


Interoreter temporarily. stops reading the card file Cthe card 
file remains open)», and starts reading from the "SYSIN" file. 
Upon reaching end-of-file on the SYSIN file» the 1400 Interpreter 
resumes reading the regular card files "SYSIN" can be looked 
upon as “inserting” the SYSIN file into the card file. The 
following exeapte itlustrates mie use of the SYSIN option: 


Card File a “SYSIN Eile 

2 DATA CARDS-1400 ° ——?-_:DATA -CARDS.1400 
INTOPT SYSIN : <object program deck> 
<data deck> . 2? END) 

2? END | 


This has the same effect as? 


2? DATA CARNS.1400 
<object program deck> 
<data deck>. 

? END 


The SYSIN file. is by default a card filler. but can be file-equated 
to a B 1800/8 1700 disk or tape file. 


The 1400/1EP syntax has teen enhanced to allow specification of 
the SYSIN filer and the CARD.READER syntax: has been enhanced to 
facilitate =apeebrMeanron of B 1800/B 1700 disk or tape files, as 
follows: © 


NAME = Spicer pe aanD eae dees eae 


: 
Co 

( CARD.READER ) (€ C PACK.ID ) 

Cc . ee ee ) = <PACK@ID>. 

( SYSIN ») € € PID ) | 
¢ : 
C ( CARD.READER ) 
( DEVICE = € CRD ) 
( ( DISK ) 
C ( TAPE ) 


The following example specifies that the SYSIN file ts a disk 
file Labeled "L400/PROG" and that the card file is a card deck 
labeled "CARDS*: : lake 


CARD-READER NAME = CARDS» DEVICE = CARD-READER? 
SYSIN NAME = 1400/PROG» DEVICE = DISKS 
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The default name for both the CARD-READER and SYSIN files is 
"CARDS.21400". "DEVICE = CARD.READER" is the default if a device 
%8S not specified. Also note that the disk file ts not a pseudo 
readers but is created using the *CRODSK" function of OMPALL Cor 
any similar card-to-disk program). 


Alt INTOPT cards must precede any 1400 program or data cards. 
The SYSIN file may contain INTCPT cards» as tong as the preceding 
rule is not viotated. Upon encountering an INYOPT RCB-ALLOWED 
cards both the SYSIN file and the card file are closecr and the 
binary card file is then opened. 


The 8B 1800/8 1700 internat file name for the SYSIN file is 
"SYSIN". If the environment was compiled with a L400/ITEP prior 
to the Mark VII.O reteaser the internal name of the SYSIN file is 
"CARDS.2". ; » Se . 
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20-21. Introduction. 


The Burroughs Electronic Data Processing Time Analysis and 
Billing System (TABS) >» as implemented for the B 1800/8 1700 
systems» provides each user with the. opel eee to obtain a 
comprehensive ae. ‘of the system tog files 


TABS ts’ designed to analyze the log fitess: aeere the extracted 
statistics to generate reports on machine utilization and program 


performance. As the reports are produceds monthto-date and 
billing=period- to-date statistics are maintained in permanent 
data files. Together with the information on ‘installation costs 


assigned. by the usere these statistics can be used to distribute 
the cost of the entire ‘system equitably among the individuals» 
departments» or applications utilizing the computer system. 


The TABS package» consisting of ten separate programse is a. 
program product which may be ‘ordered separately. Documentation. 
on the, use af the TABS programs is available with the program 
product. in. ‘the “form ~of "a ‘printer. backup file tabeted 
DOCUMENT/TABS. | The 8 1800/8 1700 TABS package can be ordered 
through the tocal Burroughs ‘branch office ‘from hredess Products 
Distribution. ; 


B1800/81700 System Software Release Mark VII.0 
1. General Information 


isl. Introduction. 


The Mark VIIT.0 software release includes a number of major 
enhancements» described in detail in the following sections of 
this release document. | Among the new enhancements and features 
are the following (Cthe numbers in parentheses refer to the 
paragraphs in this document that describe the features’ in 
detail): | 


1. New emenory | management algorithas have been implemented in 
the MCP» . using three optional levels of sophistication and 
complexity (2.2.2). 


Ze Capabilities for dynamically sonitoring and displaying 
system performance have been ean hesented in the MCP and 
GISMO/DEBUG (2.2.3). 


3e tiesnusbers have been replaced by job-numbers> allowing use 
of a single» consistent number for alt job identification 
(2.204). "i ; , : 


4. The XM function has been iaplemented in the MCP and System 
Initializer CSYSTEM/INIT)>» allowing specified areas of 
memory to be removed from use during the CLEAR/START 
operation (2.2.10). a 


5. The meaning of the STATE Light has been changed to attow 


providing a more accurate and meaningful indication of how 
"busy*™ the processor is (2.2.13). . 


6. The 8 1800/8 1700 Time Analysis and Billing System (TABS) 
has been implementede including new event-oriented records 
placed in the SYSTEM/LOG by the MCP (2.2.39 and 20-1). 


re The capability to. create Instattlation. Abtecsted Disk files 
. has been imptemented in the MCP and a new utility prograe» 
DISK/ALLOCATOR (2.2240 and 18.2.5). 


8. The AUTOLOAD facility has been implemented in the MCP and 
DISKETTE/COPYs attlowing pseudorreader files on diskatte to 
be copied to system disk without operator action (2.2.44 
and 18.2.6)... 


9. The two methods for 1/0 SEQUENTIAL disk file access» 
originally tiaplemented in patch #40 to Mark VI.1s have been 
included in the Mark VII1.0 MCP and MICRO.MCP (2.2.64). 


10. 
11. 


12. 


13. 


Lae 
15. 
16. 
17. 


18. 


19. 


20. 
21. 
226 
236 
246 


25. 


The per formance of the DIV (divide) and SQRT (square root) 
operations in RPG has been significantly tmproved (4.2.9). 


The maximum number of files that may be declared in an RPG 
source program has been increased to 31 (4.4.1).- 


Source file maintenance capability has been implemented in 
RPG» allowing disk or tape source™image files to be updated 
with patch records» as well as pear gne the source library 
copy facility. C4 e4e2)~ 


The EXTEND option of the OPEN verb has been implemented in 
COBOL» allowing an existing disk file to be opened output 
with automatic positioning of the record pointer to the end 
of the file (522215 and 54.1). 


The coBot compiler now segments the generated subroutines 
used for handling ISAM files (5.4.11). 


The free-format 1/0 C"stash editing”) capability has been 
iaplemented in FORTRAN (7. eld 


DMSII now provides record= level (rather than physical 
block=level) tockout (9.2.3). 


The DOMSII reorganization programs are now erestartable 
€92204)- a” BS 


A number of standardization changes have been made to DASDL 


syntax» including isaplementation of new compiler options 


(92226). 

In conjunction with Priority Memory Management and Extended 
Segment Decay» data coma peformance has been significantly 
improved (10.2.7). 


The capability to declare global defines has been provided 


in the NOL compiler (10.4.5). 


It is now possible for an MCS to ceebare a REMOTE FILE*INFO 
operation on any remote file €10.4.14).. 


CANDE can “now support up to 64 terminals Lugoed on at the 
same time (11.2.6). 


The CANDE AUDIT capability can now be dynamically gtarted 
or stopped» using operator commands (11.2210 and 11-4.13). 


TEXT/EDITOR now provides the ability to display a printer 


backup disk file at the terminal. (12.2.3). 


TEXT/EDITOR includes a number of significant improvements 
in the FIND» © REPLACE® = and SEARCH commands (12.2.5 and 


12.2.6). 


Program Identification Version Compile Date Remarks 


*SHCS WIT LO 4/28/78 
CANDE VIT.0 5719778 
CANDE/ANALYZER VIT-0 1/24/78 
CANDE/TEACH.FILE VII.0 Lis 9/77 

IVEDITOR VIT.0 6/30/78 
VII.0 1/17/78 
RJE/DCH VII.0 1/17/78 
RJE/MCS VIT.0 1/17/78 
RJE/ AUTOBACKUP VII.0 10/10/77 
RJE/CONTROLLER VII.0 1/30/78 
RJE/MESSAGES | VII-0 1/18/78 

*RJE3780 VIT.0 6/ 6/78 
HASP VII.0 4/14/78 
HASP/SPOOL VIT.0 5/24/78 
HASP/MODIFTER VII .0 2/ 6/78 
B500/LEP VIT.0 9/30/77 
BSOO/INTERP2U— VII .0 7/12/78 
1400/1EP VII-9 © 12/ 1777 
1400/INTERP2U VII .0 4/26/78. 
1400/CREATE1311. VI.0 9/ 6/76 
SORT «@ VITO 3/22/78 
SORT/COLLAT VI-l 8/19/77 
SORT/MERGE VITO 9/ 9/77 
SORT/OSORT VIT.0 4/ 7/78 
SORT/TAPESORT VIT.0 11/ 7/77 
SORT/VSORT — VII.0 3/23/78 
MCPIT/ANALYZER VII.0 6/30/78 
DUMP/ ANALYZER VII .0 6/22/78 
CODE/ANALYZER VII.0 12/ 7/77 
DISK/COPY VII .0 3/29/78 
DISKETTE/COPY | VII.0 4/26/78 

*SYSTEM/ICMD.INIT VII .0 12/21/77 
SYSTEM /BACKUP VII.0 6/12/78 

* SYSTEM/CONP ARE VII .0 6/28/78 
SYSTEM/LOGOUT VII.0 1/24/78 
SYSTEM/ELOGOUT VII .0 6/ 3/78 
SYSTEM/SPOLOGOUT VIel 8/22/77 
SYSTEM/LDCONTRL VII .0 11/ 3/77 
SYSTEM/LOAD.CAS VII.0 9/30/77 
SYSTEM/LOAD.OUMP VII .0 5/23/78 
SYSTEM/DISK INIT VII-0 6/ 5/78 

_ SYSTEM/DISK.DUMP VITO 7/28/77 
SYSTEM/BUILDTRAIN VI. 8/19/77 
SYSTEM/TRAINTABLE VII.0 10/21/77 
INPUT/PC5. TABLES VIT.0 10/21/77 
SYSTEM/MAKEUSER | VII.0 1/27/78 


Program Identification Version Compile Date Remarks 


*eSYSTEM/MARK.SEGS 


VII .0 3/23/78 
*DISK/ALLOCATOR VII.0 8422777 
SYCOPY . VII .0 8/ 4/77 
TAPECOPY | VII.0 8/22/77 
CHECK/LOAD .OUMP VII .0 6/ 3/78. 
DISKMAP/UTILITY VII.0 6/ 3/78 
QWIKLOG | VII .0 6/28/78 
LOGCONVERT | VII-O 6/28/78 
FILE/LOADER Vel 10/29/75 
FILE/PUNCHER V.0 1/31/75 
DMPALL VII.0 6/27/78 
*TABS/LOGOUT VIT.0 4/15/78 
*TABS/ACCTS VIT.0 4/13/78 
*TABS/BILLING VIT.0 5/4 9/78 
*TABS/ERR VII.0 5/11/78 
* TABS/EXEC VIT.0 5/4 3/78 
*TABS/HDWR VII.0 | 4/17/78 
*TABS/MIX VII .0 4/13/78 
* TABS /REPORTGEN VII.0 4/17/78 
_*TABS/SUM VIT.0 4/13/78 
*TABS/UPDATE VII.0 4/13/78 . 
. DISK/DUMP . — WIel 8419777 Note 3 
* STANDALONE /DTSK -DUMP VII.0 . 6412/78 Note 3 
DISK PACK INITEALIZER | VIL .0 6/27/78 © Note 3 
DISK CARTRIDGE INITIALIZER VII.0O- 8/29/77 © Note 3 
DISKPACK/INTERCHANG VI .0 12/ 2/76 : 
STANDALONE /INTERCHANG VI.l 8/19/77 Note 3 
SYSTEM/INIT VII .0.1° 7/ 1/78 © 
CLEAR/START | VII.O 2417/78 Note 3 
COLDSTART/TAPE VII .0 9/30/77 Note 3 
COLDSTART/DISK VII.0 12/ 2/77 Note 3 
SSLOAD/MAKCAS VII .0 12/ 5/77 
CASSETTE /MAKER VIIT.0 9/19/77 
CASSETTE/LOADER VIe1 9/ 7/76 Note 3 
SDL/INTERPIU VITO 10/10/77 Note 3 
GISMO/SA VIT.061 7/ 1/78 Note 3 
Note 1: Interpreter is usable only on B 1710 and 8 1830/B 1825 
processors. 
Note 2: Interpreter is usable only on @ 1720 and 8B 1800 
processors Cother than the B 1830/B 1825). 
Note 3: Code file used in making stand-alone program cassettes» 


using the SSLOAD/MAKCAS program. Attempts to execute 
the code fite under MCP control should not be made. 


